Unity Localization 发布前检查:字符串表为什么也会出现 TMP 缺字

项目已经做了 Unity Localization,为什么切换语言后仍然会出现方框字?

字符串表只负责提供文案,并不保证文案里的每个字符都能被 TextMeshPro 当前字体覆盖。翻译新增的专有名词、标点和特殊符号,都可能超出原字体或回退链的范围。

一个常见漏测场景

主菜单只测试了“开始游戏”“设置”“退出”这些常用词。版本发布后,某个活动页面的日文文案包含新的品牌名,字体回退没有覆盖对应字符,问题才第一次出现。

原因是测试场景只覆盖了已加载的界面,而 StringTable 里的完整字符集没有被系统检查。

发布前应检查什么

字体资产

  • Font Asset 是否对应目标语言。
  • 静态图集是否包含预期字符。
  • 动态字体源文件是否随项目提供。

回退链

  • Font Asset 的本地 Fallback 是否指向有效资产。
  • TMP 全局 Fallback 是否覆盖本地回退遗漏。
  • 回退链是否出现空项、重复项或循环。

Localization 数据

  • 所有目标语言的 StringTable 是否进入扫描范围。
  • 新增或修改的字符是否经过字体覆盖检查。
  • 是否只检查了默认语言而遗漏其他语言。

推荐的两层验收

第一层是静态字符检查:遍历所有 StringTable 的字符集,与字体回退图比对。

第二层是真机界面验收:切换每个目标语言,打开主要页面、弹窗和活动入口,确认布局、换行与字体渲染。

两层都需要。静态检查能覆盖大量未加载文案,真机测试则能发现裁剪、换行和视觉风格问题。

用 GlyphGuard 检查字符串表

在项目中执行:

  1. 打开 Tools > GlyphGuard > Run Audit。
  2. 导入的 Unity Localization StringTable 会参与字符覆盖检查。
  3. 在 HTML 报告中查看缺失字符、组件路径和相关规则编号。
  4. 修复后重新运行,直到缺字和回退链 Error 清零。

Unity Localization 是可选依赖。项目没有使用时,工具仍会检查 Prefab、场景和字体回退配置。

不要把所有 Warning 都忽略

例如动态字体缺少可读取的源字体时,工具无法证明字符覆盖,只能给出 Warning。此类问题应结合打包环境、系统字体策略和人工测试决定是否阻断发布。

建议将 Error 作为 CI 门禁,将无法自动证明的 Warning 保留在发布检查记录中。


相关工具:GlyphGuard - TextMeshPro 缺字与字体回退检查