管理本地化内容

完成快速开始后，可以按需要扩大收集范围、增加语言或交给翻译人员协作。本页介绍这些功能的入口和最基本的操作。

收集项目内容

在首页选择“源语言（原文语言）”，展开“配置收集组”，选择收录目录，再点击“收集并统计”。游戏 Demo 使用 assets 根目录即可。

配置	用法
收录目录	选择要处理的 assets 根目录或子目录；空输入不代表全部资源
文件扩展名	需要限制文件类型时填写，例如 ts
排除目录	从收录范围中排除某个子目录

目录输入框中的 assets/ 是项目路径前缀。使用选择器选择根目录后，不必再次输入 assets。排除目录应选择 assets 下的子目录。

先确定收集范围，再执行收集；入门示例不需要额外过滤规则

收集可以处理场景、预制体中的 Label、脚本中的静态 l10n.t() 调用，以及图片、音频、视频和字体资源。再次收集会保留已有本地化关联和译文；没有新增条目不一定表示收集失败。

已有内容后再更换源语言，应先阅读确认框。 确认后立即保存，新语言会用于后续收集和翻译；新源语言缺少的条目可能复制旧源语言内容，需要你再审阅原文，不会自动翻译。

添加语言与编辑译文

在“编译语言”中点击“添加新语言”，按名称或语言代码选择。源语言行的“补充源文案”用于维护原文，目标语言行的“翻译”用于填写译文。

翻译页使用三个分类：

• 未翻译／待补充：尚未保存内容的条目。
• 已翻译／已填写：已有保存内容的条目。
• 已导入文件：从翻译文件暂存进来的内容。

选择一行，展开下方“条目详情”可查看 Key 和关联资源。先输入译文，再点击右上角“保存”。输入期间条目可能仍留在原分类，保存后再到“已翻译”核对。

翻译页提供未翻译、已翻译和已导入文件分类，右上角为保存入口

手工填写、自动翻译、文件导入、媒体匹配和变体确认都会先产生草稿。离开页面时如有未保存内容，按提示继续编辑或丢弃草稿。

复数变体

同一句话可能随数量改变形式，例如英语的 1 point 和 2 points。在已有基础译文的文字条目旁点击“变体”，按当前语言提供的数量形式填写完整句子。

需要显示数量时，在文字中保留 ，例如 Score: point 和 Score: points。不需要显示数字的文案也可以使用变体。

展开“测试数量”，输入 1、2 等数量，可看到选择的形式和显示文字。语言之间的数量规则不同：英语通常区分 one 与 other，中文通常只需要一种形式；这里不支持自定义 count > 100 一类条件。

填写数量形式后，使用“测试数量”检查，再确认并保存页面

变体弹窗的“确认”只更新草稿，还需要点击翻译页“保存”。“清除变体译文”也只修改变体草稿，会保留基础译文。

实际游戏通过 L10nLabel 的 Count 或 l10n.t(key, { count: 2 }) 选择形式，普通 Label 不会自动按数量切换。脚本示例见脚本 API。

媒体本地化与智能匹配

不同语言可以使用不同的图片、音频、视频或字体。先把目标资源导入项目 assets，再在目标语言的媒体条目中选择资源，或填写 assets 下的相对路径，最后保存页面。

例如目标文件为 assets/ui/zh-Hans/start.png，填写 ui/zh-Hans/start.png。路径必须能解析到项目内已有的资源；文本自动翻译不会生成媒体文件。

智能匹配

大量资源按语言目录存放时，可在“未翻译”中使用“按路径匹配资源”。填写“查找路径文字”和“替换为”，核对范围后继续。

例如项目同时有 ui/en/start.png 和 ui/zh-Hans/start.png，将 ui/en/ 替换为 ui/zh-Hans/，即可为对应条目准备中文资源草稿。匹配只处理目标资源为空的媒体条目，不覆盖已有目标资源。审阅结果并保存后，再检查游戏显示。

按项目实际目录填写路径替换规则；目标语言资源应先导入项目

L10nLabel 组件

L10nLabel 使用 Key 将场景 Label 与翻译条目关联。选择节点后，在属性检查器中找到组件：

操作	用法
选择	搜索并关联已有文字条目
生成	准备新 Key；还需要收集或创建条目并填写原文、译文
编辑	打开本地化编辑器维护内容
保存／重置	修改 Key 后显示，用于应用或放弃当前 Key 草稿
Count	为数量变体提供数值

选择同一 Key 可复用已有译文；修改关联后还要保存场景

保存译文、保存 Key 关联和保存场景分别处理不同内容。只改译文时通常无需更换 Key。

翻译文件协作

语言行的“导出”可选择 PO、CSV 或 XLSX；“全部导出”用于批量交付。导出前先保存译文，并告诉翻译人员目标语言。填写时保留 Key 和 等占位符。

收到文件后，进入对应目标语言的翻译页，选择“导入文件”。在“已导入文件”中审阅，点击页面“保存”写入项目。

冲突处理

提示	怎么处理
导入冲突	再次导入的文件与已暂存文件含相同 Key 时，选择跳过重复、覆盖草稿或取消导入
Catalog 冲突	保存时明确勾选允许覆盖的项目条目，再点击“保存选中项”

允许导入覆盖草稿，不等于已经允许覆盖项目数据；保存时再核对 Key

保存后重新进入同一语言，确认修改已保留，再检查实际界面。完整项目备份还应包含场景关联和配置，导出表格不能替代项目备份。

语言与数据管理

目标语言行可删除该语言及译文；源语言不能在这里删除。操作前先导出需要保留的内容，并阅读确认框。

更多操作中的“清除数据”用于移除目标语言及其数据，保留源语言。翻译服务区域的“清除配置”只处理服务账号配置，与清除项目译文不同。