Flutter iOS端自定义字体失效且首字符缺失问题排查

• 大小写敏感问题：Windows文件系统不区分大小写，但iOS（基于macOS）严格区分。检查pubspec.yaml里配置的字体路径、文件名，和assets/目录下的实际文件是否完全一致（包括大小写）。比如你写了assets/fonts/MyFont.ttf，但实际文件是myfont.ttf，Android能正常加载，iOS就会找不到字体。
• 字体Family名称不匹配：自定义字体的Family名不一定是文件名，需要确认字体本身的PostScript名称（Mac上可以用Font Book打开字体，查看“信息”里的PostScript名称）。如果pubspec.yaml里family字段填的和实际字体的名称不一致，iOS会无法识别，自动回退到系统默认字体。
• 缓存残留：iOS模拟器的缓存可能导致旧资源没有更新。执行flutter clean，然后删除模拟器上的应用，再重新运行flutter run，必要时可以手动清理模拟器缓存（路径：~/Library/Developer/CoreSimulator/Devices，找到对应模拟器的文件夹删除）。
• 字体文件兼容性：部分字体在Android上能正常解析，但iOS对字体格式的要求更严格。检查字体文件是否是标准的TrueType(.ttf)或OpenType(.otf)格式，有没有损坏。另外，如果你用的字体不包含emoji字符集，iOS在渲染时可能出现异常，甚至连带截断常规文本。
• 布局适配问题：当自定义字体加载失败回退到系统字体后，两种字体的字符宽度、行高存在差异，原来基于自定义字体的布局计算（比如固定宽度的容器、padding设置）会导致文本被截断。这种情况本质还是字体加载失败引发的连锁问题，解决字体加载后布局会自动恢复。

内容的提问来源于stack exchange，提问作者Ross Llewallyn