键保留 · Lingo.dev

保留键会先用源内容初始化一次，之后便不再受自动更新影响。CLI 永远不会覆盖它们——它们适合作为需要人工翻译内容的占位值，例如法律文本、合规文案或营销标语。

配置方法#

在 i18n.json 的某个 bucket 中添加 preservedKeys：

json

{
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"],
      "preservedKeys": ["legal/privacy", "legal/terms"]
    }
  }
}

工作方式#

以下面这份源文件为例：

json

{
  "welcome": "Welcome to our platform",
  "legal": {
    "privacy": "We respect your privacy and protect your data.",
    "terms": "By using this service, you agree to our terms."
  }
}

首次运行时，CLI 会原样复制保留键，同时翻译其余所有内容：

json

// locales/es.json (first run)
{
  "welcome": "Bienvenido a nuestra plataforma",
  "legal": {
    "privacy": "We respect your privacy and protect your data.",
    "terms": "By using this service, you agree to our terms."
  }
}

当你手动翻译完法律相关部分后，之后的 CLI 运行都会保留你的译文不变。

键保留 vs. 键锁定#

	键保留	键锁定
初始值	以源值作为占位值	源值（始终如此）
手动修改	永久保留	每次运行都会被源值覆盖
适用场景	法律、合规、人工翻译	品牌名称、技术 ID

键路径写法#

嵌套键使用正斜杠 (/)，通配符使用星号 (*)：

json

{ "preservedKeys": ["legal/*", "marketing/tagline"] }

下一步#