适用版本
原环境为 macOS 15.0、Flutter 3.24.2、Xcode 16.0,记录于 2024 年 9 月。
2024 年 9 月的 macOS 桌面项目启动后窗口空白,但组件仍可以点击,控制器初始化日志也在输出。这个现象说明应用逻辑仍在运行,故障集中在界面渲染链路。
原始环境
| 项目 | 记录值 |
|---|---|
| Flutter | stable 3.24.2 |
| macOS | 15.0,24A335 |
| Xcode | 16.0,16A242d |
| 系统区域 | zh-Hans-CN |
| 运行架构 | darwin-x64 |
日志重复出现:
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 系统重现到日常开发环境。


