|Labs
预约演示平台
React(Lingo Compiler)
Alpha
React (MCP)React(i18n)旧版 CLI(v0)
已废弃

Lingo.dev CLI

  • 工作原理
  • 快速开始
  • 快速上手
  • Monorepos

配置

  • 支持的格式
  • i18n.json
  • i18n.lock
  • 支持的语言区域

功能特性

  • 现有翻译
  • 添加语言
  • 覆盖
  • 翻译注释
  • 翻译键
  • 键重命名
  • 键锁定
  • 键忽略
  • 键保留
  • 借助 AI 提取键

性能

  • 大型项目
  • 并行处理
  • 成本预估

重新翻译

  • 自动重新翻译
  • 重新翻译
  • 删除翻译

此处文档涵盖的是旧版 CLI(v0),现已废弃。当前版本的 CLI 为 v1。 查看当前 CLI 文档

键锁定

被锁定的键会直接从源文件复制到所有目标文件,无需翻译。Lingo.dev CLI 会将这些键完全排除在翻译流程之外,并在所有语言中保留原始源值。

配置方法#

将 lockedKeys 添加到 i18n.json 的某个 bucket 中:

json
{
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"],
      "lockedKeys": ["brand/name", "config/apiUrl", "system/version"]
    }
  }
}

工作方式#

假设有这样一个源文件:

json
{
  "welcome": "Welcome to our platform",
  "brand": {
    "name": "Lingo.dev"
  },
  "config": {
    "apiUrl": "https://api.example.com"
  }
}

启用 "lockedKeys": ["brand/name", "config/apiUrl"] 后,西班牙语目标文件会变成:

json
{
  "welcome": "Bienvenido a nuestra plataforma",
  "brand": {
    "name": "Lingo.dev"
  },
  "config": {
    "apiUrl": "https://api.example.com"
  }
}

只有 welcome 会被翻译;锁定的键会完整保留源值。

键路径表示法#

使用正斜杠(/)来定位嵌套键:

json
{ "lockedKeys": ["system/engine/component"] }

使用星号(*)来匹配多个键:

json
{ "lockedKeys": ["navigation/menuItems/*"] }

即使键名中包含点号,也能正常工作——modules/ai.translation 会定位到 "modules" 内部的键 "ai.translation"。

键锁定 vs. 键忽略#

键锁定键忽略
是否出现在目标文件中是——保留源值否
适用场景品牌名称、技术 ID、URL调试字符串、内部标记、测试数据

下一步#

键忽略
将键从目标文件中完全排除
键保留
初始化一次,后续更新不再覆盖
翻译键
查看所有键级控制方式
i18n.json
完整配置参考

这个页面对你有帮助吗?

Max PrilutskiyMax Prilutskiy·已更新 5 天前·1 分钟阅读