翻译键 · Lingo.dev

Lingo.dev CLI 提供四种键级控制，用来决定各个翻译键在处理过程中的行为。它们各有明确用途：

控制方式	配置字段	行为
键锁定	`lockedKeys`	将源语言的值原样复制到所有目标语言中，不进行翻译。这些键会出现在目标文件里，且值完全一致。
键忽略	`ignoredKeys`	将键完全排除在处理流程之外。它们不会出现在目标文件中。
键保留	`preservedKeys`	仅在首次从源语言初始化时写入，之后不再自动更新。专为需要人工翻译的内容而设计。
键重命名	自动	自动检测键是否被重命名，并保留已有翻译。无需额外配置。

如何选择#

当某个键的值必须在所有语言中保持一致时，使用 Lock——例如品牌名称、技术标识符、配置值：

json

{ "lockedKeys": ["brand/name", "config/apiUrl"] }

当某个键根本不应该出现在目标文件中时，使用 Ignore——例如调试字符串、内部标记、测试数据：

json

{ "ignoredKeys": ["internal/debug", "dev/testData"] }

当某个键需要人工翻译时，使用 Preserve——例如法律文本、合规内容、需要人工审核的营销文案：

json

{ "preservedKeys": ["legal/privacy", "legal/terms"] }

Renaming 是自动进行的——CLI 会检测键名发生变化但内容保持不变的情况，并在无需重新翻译的前提下沿用已有翻译。

所有键数组在表示嵌套路径时都使用正斜杠 (/) 记法，并使用星号 (*) 表示通配符：

json

{
  "lockedKeys": ["brand/name"],
  "ignoredKeys": ["internal/*"],
  "preservedKeys": ["legal/privacy/full"]
}

名称中包含点号的键也能自然处理——正斜杠用于分隔层级，因此 modules/ai.translation 可以准确定位 "modules" 对象中的键 "ai.translation"。