303 多语言与本地化
使用 Codex 批量翻译技术文档，处理 i18n 文件，确保术语一致性和翻译质量
学习目标
一、技术文档批量翻译
基本翻译命令
# 翻译 Markdown 文件
codex translate README.md --to zh-CN
# 批量翻译整个文档目录
codex translate docs/ --to ja,ko,zh-CN
# 翻译并保留原始格式
codex translate docs/ --to zh-CN --preserve-formatting翻译质量参数
# 高质量翻译（适合正式文档）
codex translate api-docs.md --to zh-CN --quality high
# 快速翻译（适合内部草稿）
codex translate notes.md --to zh-CN --quality fast
# 带审阅的翻译流程
codex translate docs/ --to zh-CN --review**💡 提示：** `--review` 模式会生成双语对照版本，方便人工校对关键术语的翻译准确性。
二、i18n 文件自动化
处理 i18n 文件
# 从源语言生成其他语言的 i18n 文件
codex i18n --source en.json --targets zh-CN,ja,ko
# 同步新增的 key 到所有语言文件
codex i18n --sync
# 检测缺失的翻译
codex i18n --check-missing支持的 i18n 格式
| 格式 | 框架/工具 | 示例 |
|---|---|---|
| JSON | i18next, react-intl | `{"greeting": "Hello"}` |
| YAML | Rails i18n | `greeting: Hello` |
| PO/POT | gettext | `msgid "Hello"` |
| XLIFF | 专业翻译工具 | XML 格式 |
工作流示例
# 1. 提取源码中所有可翻译字符串
codex i18n --extract src/
# 2. 生成翻译文件模板
codex i18n --init --langs zh-CN,ja,ko
# 3. AI 翻译所有目标语言
codex i18n --translate-all
# 4. 检查翻译完整性
codex i18n --check-missing --fail-on-incomplete三、术语一致性管理
术语表配置
`.codex/glossary.yaml`：
glossary:
- source: "API endpoint"
zh-CN: "API 端点"
ja: "API エンドポイント"
notes: "不使用 'API 接口'，避免与 Interface 混淆"
- source: "deploy"
zh-CN: "部署"
notes: "不使用 '发布'，Release 才用 '发布'"
- source: "container"
zh-CN: "容器"
notes: "特指 Docker 容器时使用，泛称用 '集装箱'"术语检查
# 根据术语表检查翻译一致性
codex i18n --check-terminology
# 输出不一致的术语
codex i18n --check-terminology --report terminology-issues.md四、本地化质量检查
质量检查维度
# 全面质量检查
codex i18n --quality-check检查内容：
| 检查项 | 说明 |
|---|---|
| 占位符完整性 | `{name}`, `%s`, `{{count}}` 是否保留 |
| HTML 标签配对 | `<strong>...</strong>` 是否完整 |
| 复数规则 | 各语言的复数形式是否正确 |
| 长度限制 | 翻译后文本是否超出 UI 限制 |
| 特殊字符 | URL、代码片段是否被误翻 |
检查报告
# 生成质量报告
codex i18n --quality-check --output i18n-quality-report.html五、Codex + DeepSeek 中英翻译实践
组合使用策略
# 使用 Codex 协调多模型翻译工作流
codex translate docs/ --to zh-CN --pipeline "
1. DeepSeek: 初译（中文表达更自然）
2. Codex: 术语一致性审查
3. Codex: 技术准确性校验
4. 输出双语对照审阅版
"适用场景对比
| 场景 | 推荐方案 |
|---|---|
| 技术文档英译中 | DeepSeek 初译 + Codex 审查 |
| 技术文档中译英 | Codex 直接翻译 |
| 多语言 i18n | Codex 批量处理 |
| 文学性内容 | DeepSeek 优先，保证可读性 |
六、本课总结
**核心要点：**
- `codex translate` 支持单文件和批量翻译，保留原始 Markdown 格式
- `codex i18n` 全流程管理：提取 → 翻译 → 同步 → 质量检查
- 术语表 (`.codex/glossary.yaml`) 是保证翻译一致性的关键
- `--quality-check` 自动检测占位符、标签、复数等常见问题
- Codex + DeepSeek 组合可实现更好的中英双向翻译质量
**下一步：** 学习定时任务与自动化 → [304 定时任务与自动化](module4-304.md)