支持的语言区域

Lingo.dev CLI 支持遵循国际语言识别标准的语言区域代码。您可以在 i18n.json 配置中使用简单的语言代码、区域变体以及特定平台的格式。

CLI 接受多种格式的语言区域代码，以满足不同项目需求和平台约定。

语言区域代码格式

Lingo.dev CLI 支持多种语言区域代码格式：

简单语言代码 (ISO 639-1)：

{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja", "zh"]
  }
}

区域变体 (BCP 47)：

{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-ES", "es-419", "fr-FR", "fr-CA"]
  }
}

特定平台格式：

{
  "locale": {
    "source": "en",
    "targets": ["en-rUS", "es-rES", "pt-rBR"]
  }
}

检查支持的语言区域

要查看所有可用的语言区域代码，请使用以下 CLI 命令：

列出支持的源语言：

npx lingo.dev@latest show locale sources

列出支持的目标语言：

npx lingo.dev@latest show locale targets

这些命令将显示您可以在配置中使用的完整语言区域代码列表。

常见语言区域示例

主要语言：

• en - 英语
• es - 西班牙语
• fr - 法语
• de - 德语
• ja - 日语
• zh - 中文
• ko - 韩语
• pt - 葡萄牙语
• it - 意大利语
• ru - 俄语

区域变体：

• en-US - 英语（美国）
• en-GB - 英语（英国）
• es-ES - 西班牙语（西班牙）
• es-419 - 西班牙语（拉丁美洲）
• fr-FR - 法语（法国）
• fr-CA - 法语（加拿大）
• zh-CN - 中文（简体）
• zh-TW - 中文（繁体）

地区变体

地区变体使您能够通过本地化内容针对特定市场，考虑到同一语言中的文化和语言差异。

配置示例：

{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-ES", "es-419", "pt-BR", "pt-PT"]
  }
}

生成的文件结构：

locales/
  en-US.json    (源语言)
  en-GB.json    (英式英语)
  es-ES.json    (西班牙西班牙语)
  es-419.json   (拉丁美洲西班牙语)
  pt-BR.json    (巴西葡萄牙语)
  pt-PT.json    (欧洲葡萄牙语)

每个地区变体都会接收针对该特定市场术语和文化背景优化的翻译。

拉丁美洲西班牙语 (es-419) 涵盖拉丁美洲的西班牙语国家，使用适用于整个地区的术语和表达，而不是针对单个国家。

平台特定格式

某些平台使用不同的语言代码约定。Lingo.dev CLI 支持以下格式：

Android 资源目录：

{
  "locale": {
    "source": "en",
    "targets": ["es-rES", "pt-rBR", "zh-rCN"]
  },
  "buckets": {
    "android": {
      "include": ["android/values-[locale]/strings.xml"]
    }
  }
}

iOS Localizable.strings：

{
  "locale": {
    "source": "en",
    "targets": ["es", "pt-BR", "zh-Hans"]
  },
  "buckets": {
    "xcode-strings": {
      "include": ["ios/[locale].lproj/Localizable.strings"]
    }
  }
}

书写系统变体

对于具有多种书写系统的语言，请使用书写系统代码：

• zh-Hans - 中文（简体）
• zh-Hant - 中文（繁体）
• sr-Cyrl - 塞尔维亚语（西里尔字母）
• sr-Latn - 塞尔维亚语（拉丁字母）

配置示例：

{
  "locale": {
    "source": "en",
    "targets": ["zh-Hans", "zh-Hant", "sr-Cyrl", "sr-Latn"]
  }
}

添加新语言区域

Lingo.dev CLI 目前支持 80 多种语言区域，并且我们会在收到社区请求后快速添加对新语言区域的支持。

如果您需要的语言代码尚未支持，可以通过在 Lingo.dev CLI 仓库 中提交问题来请求。大多数请求会在几天内实现并发布。