Unity 多语言本地化
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/unity-technologies-skills-localization。
技能介绍
要解决什么问题
在 Unity 项目里做多语言,最容易踩坑的不是「翻译文案」,而是 Editor API 与运行时行为不一致:包没装好却静默失败、按 GetLocales() 顺序填表导致语种错位、改完 String/Asset Table 却不通知编辑器而界面一直显示旧数据。中日韩更麻烦:用 Western 字体或 TMP Fallback 会直接出现 tofu(方框字),而 Addressables 与 Asset Table 的 GUID 不同步又会报 Failed to load sub-asset。
技能如何帮你落地
这份指南按工程顺序拆开整条链路:
- 环境与表结构:用 Package Manager 确认
com.unity.localization,创建或激活LocalizationSettings,按需补齐 locale。 - 安全写入表数据:按
Locale.Identifier.Code显式匹配,而不是假设 locale 顺序;Asset 表用 GUID 建/更新条目,修改后SetDirty+(Unity 6+)RaiseCollectionModified+SaveAssets。 - UI 绑定:用公开的
LocalizeStringEvent接 TMP 或 LegacyText,避免反射内部 TMPro 插件;布局变更后调用LayoutRebuilder.ForceRebuildLayoutImmediate。 - CJK 字体:按 locale 做 Asset Table 字体切换,动态多图集 TMP、
Addressables构建与 tofu 验收清单。 - 存量项目迁移:抽取 UI 文案、建共享 String Table 与 Context 列、最长串优先匹配、批量处理前需用户确认。
适用边界与注意点
技能聚焦 Unity Localization 包内的配置与脚本化操作,不是通用 CAT 翻译流程管理。批量改场景不可逆,必须先确认;Resources/ 下的资源不应直接进 Asset Table。更细的 API、命名空间冲突与修复步骤见资料中的 references/api-notes.md。
使用场景
- 已有 Unity UI 预制体,需要批量挂上 LocalizeStringEvent 并把 Legacy Text/TMP 文案映射到共享 String Table
- 编辑器脚本要按语言代码写入多语言 String/Asset Table,且改完后 Inspector 必须立刻反映最新条目
- 日文/韩文/简体中文版上线前,要在 Editor 里切换 locale 做 tofu 检查并校正 Asset Table 字体引用
- 存量项目迁移时,要从场景与 Prefab 抽取硬编码字符串,按最长匹配规则避免短键误替换
适合人员
- 负责 Unity 手游/独立游戏多语言上线的客户端工程师,需要可重复的 Editor 配置与验收步骤
- 维护 Addressables 与 Localization 资源表的构建工程师,要解决 CJK 字体加载与 sub-asset 报错
- 从单语言项目扩多语言的技术负责人,要在不大面积改业务代码的前提下用 L10n 封装注入翻译
- Unity 工具向开发者,编写批量场景处理或字体切换脚本,并清楚何时必须向用户确认不可逆操作