开源项目的本地化与国际化如何分离

本文目录导读：

1. 核心分离原则
2. 具体实施步骤
3. 常见工具与框架的实现方式
4. 高级分离：区域规则与翻译内容分离
5. 避免的陷阱

开源项目的本地化与国际化分离,通常遵循代码与翻译内容解耦的原则，核心思路是：国际化（i18n）负责机制，本地化（l10n）负责内容，以下是具体的分离策略和实践方法：

核心分离原则

• 国际化（i18n）：在代码中通过抽象层（如 i18n() 函数、ICU MessageFormat）标记所有需要翻译的字符串，并定义语言环境（locale）和区域规则（日期、数字格式），这部分由开发者负责。
• 本地化（l10n）：将翻译内容（JSON/YAML/PO 文件）与代码分离，由翻译人员、社区或自动化工具（如 Crowdin、Transifex）独立维护，这部分不涉及代码逻辑。

具体实施步骤

步骤1：代码中只保留语言标识符（Key）

• 不要硬编码显示文本,而是使用 Key 或 ID。

• 示例（JavaScript/React）：

  // 错误：直接写入中文
  <button>保存</button>
  // 正确：使用国际化函数
  <button>{i18n('save_button')}</button>

步骤2：将翻译内容放到独立的资源文件中

• 每一门语言一个文件,与代码仓库分离（或位于独立的 locales/ 目录）。

• 文件结构示例：

  locales/
    en-US.json
    zh-CN.json
    ja-JP.json
  src/
    components/
    utils/i18n.js
    (不包含任何翻译文本)

• en-US.json：

  { "save_button": "Save" }

• zh-CN.json：

  { "save_button": "保存" }