macOS 15 下 Flutter 窗口空白:vertexMain 问题记录

记录 Flutter 3.24.2、macOS 15 和中文环境下的窗口空白现象与排查过程。

适用版本

原环境为 macOS 15.0、Flutter 3.24.2、Xcode 16.0,记录于 2024 年 9 月。

本文目录
  1. 原始环境
  2. 原作者的排查时间线
  3. 上游问题记录
  4. 留下有用的故障信息
  5. 参考

2024 年 9 月的 macOS 桌面项目启动后窗口空白,但组件仍可以点击,控制器初始化日志也在输出。这个现象说明应用逻辑仍在运行,故障集中在界面渲染链路。

原始环境

项目记录值
Flutterstable 3.24.2
macOS15.0,24A335
Xcode16.0,16A242d
系统区域zh-Hans-CN
运行架构darwin-x64

日志重复出现:

text
Couldn't find vertexMain() in library

原文有大量重复行,记录核心错误即可。GetX 控制器初始化和路由跳转日志,不能单独说明错误来自 GetX。

原作者的排查时间线

2024 年 9 月 21 日,原作者记录了以下结果:

  • 将系统首选语言改成英语后,窗口显示恢复。
  • 升级到 macOS 15.1 Beta 4 后,现象仍存在。
  • 升级 Flutter 到 3.24.3 或禁用 Material 3,没有解决当时的问题。

9 月 25 日,原记录补充:macOS 15.1 Beta 5(24B5055e)下显示恢复。这些结果来自原项目当时的设备,不应转写成所有项目的统一兼容结论。

上游问题记录

Flutter issue #154400 描述了 macOS 15、中文应用名称与系统中文环境相关的空白窗口问题。讨论中出现过将应用名称改为英文的临时处理,后续有人确认 macOS 15.1 恢复。维护者在 2024 年 11 月关闭该 issue,并将其归为 macOS 15.0 的系统问题。

因此,旧文“Flutter Skia 不支持中文路径”的推断范围过大。更准确的记录是:特定 macOS 版本与中文应用名称相关的渲染资源问题,不能概括成 Flutter 一直不支持中文路径。

留下有用的故障信息

同样的空白界面可能由其他原因造成。记录系统版本、Flutter 版本、应用名称、系统语言、架构和最早出现的渲染日志,才能与历史 issue 对照。已经解决的旧系统问题无需通过安装历史 Beta 系统重现到日常开发环境。

参考

作者:NeverOuO。原载 NeverOuO 个人小站,现收录于云屿来文章与教程。

返回全部文章

把好用的工具分享给朋友

分享

发送链接,让朋友直接打开这个页面。

访问统计

我们统计页面浏览、渠道来源、产品入口点击与分享次数,用于了解产品如何被发现。这项统计不使用用户标识、Cookie 或跨站追踪,也不读取上传文件或表单内容。