键忽略 · Lingo.dev

被忽略的键会完全跳过翻译处理。它们不会出现在目标文件中——CLI 会在内容发现阶段直接跳过这些键，也绝不会将它们发送到翻译后端。

配置#

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

json

{
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"],
      "ignoredKeys": ["internal/debug", "dev/testData"]
    }
  }
}

以下是源文件：

json

{
  "welcome": "Welcome to our platform",
  "internal": {
    "debug": "Debug mode enabled",
    "testData": "Sample test content"
  }
}

启用 "ignoredKeys": ["internal/debug", "internal/testData"] 后，西班牙语目标文件会变成：

json

{
  "welcome": "Bienvenido a nuestra plataforma"
}

目标文件中将完全不包含 internal 这一整段内容。

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

json

{ "ignoredKeys": ["internal/*", "dev/settings"] }

键名中包含点号也能正常工作——dev/api.mock 会匹配 "dev" 中的 "api.mock"。

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