Agent Skills
返回列表
💻

Unity 多语言本地化

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 或 Legacy Text,避免反射内部 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 工具向开发者,编写批量场景处理或字体切换脚本,并清楚何时必须向用户确认不可逆操作