Unity Localization 发布前检查:字符串表为什么也会出现 TMP 缺字
项目已经做了 Unity Localization,为什么切换语言后仍然会出现方框字?
字符串表只负责提供文案,并不保证文案里的每个字符都能被 TextMeshPro 当前字体覆盖。翻译新增的专有名词、标点和特殊符号,都可能超出原字体或回退链的范围。
一个常见漏测场景
主菜单只测试了“开始游戏”“设置”“退出”这些常用词。版本发布后,某个活动页面的日文文案包含新的品牌名,字体回退没有覆盖对应字符,问题才第一次出现。
原因是测试场景只覆盖了已加载的界面,而 StringTable 里的完整字符集没有被系统检查。
发布前应检查什么
字体资产
- Font Asset 是否对应目标语言。
- 静态图集是否包含预期字符。
- 动态字体源文件是否随项目提供。
回退链
- Font Asset 的本地 Fallback 是否指向有效资产。
- TMP 全局 Fallback 是否覆盖本地回退遗漏。
- 回退链是否出现空项、重复项或循环。
Localization 数据
- 所有目标语言的 StringTable 是否进入扫描范围。
- 新增或修改的字符是否经过字体覆盖检查。
- 是否只检查了默认语言而遗漏其他语言。
推荐的两层验收
第一层是静态字符检查:遍历所有 StringTable 的字符集,与字体回退图比对。
第二层是真机界面验收:切换每个目标语言,打开主要页面、弹窗和活动入口,确认布局、换行与字体渲染。
两层都需要。静态检查能覆盖大量未加载文案,真机测试则能发现裁剪、换行和视觉风格问题。
用 GlyphGuard 检查字符串表
在项目中执行:
- 打开
Tools > GlyphGuard > Run Audit。 - 导入的 Unity Localization StringTable 会参与字符覆盖检查。
- 在 HTML 报告中查看缺失字符、组件路径和相关规则编号。
- 修复后重新运行,直到缺字和回退链 Error 清零。
Unity Localization 是可选依赖。项目没有使用时,工具仍会检查 Prefab、场景和字体回退配置。
不要把所有 Warning 都忽略
例如动态字体缺少可读取的源字体时,工具无法证明字符覆盖,只能给出 Warning。此类问题应结合打包环境、系统字体策略和人工测试决定是否阻断发布。
建议将 Error 作为 CI 门禁,将无法自动证明的 Warning 保留在发布检查记录中。