lingo.dev i18n

i18n 命令的 CLI 参考文档

简介

已弃用:运行本地化流水线(建议使用 run 命令)

用法

lingo.dev i18n [options]

选项

--locale <locale>

lingo.dev i18n --locale <locale>

仅处理 i18n.json 中列出的目标语言区域代码。可重复使用该标志以包含多个区域。默认为所有已配置的目标区域。

需要一个值。

--bucket <bucket>

lingo.dev i18n --bucket <bucket>

仅处理 i18n.json 中定义的特定 bucket 类型(如 json、yaml、android)。可重复使用该标志以包含多个 bucket 类型。默认为所有 bucket。

需要一个值。

--key <key>

lingo.dev i18n --key <key>

仅处理与指定翻译键完全匹配的内容。会过滤所有 bucket 和区域,仅处理该键,适用于测试或调试特定翻译。例如:auth.login.title

需要一个值。

--file [files...]

lingo.dev i18n --file [files...]

仅处理文件路径包含这些子字符串的 bucket。例如:'components' 只处理 components 目录下的文件。

可选值。

--api-key <api-key>

lingo.dev i18n --api-key <api-key>

覆盖设置或环境变量中的 API key

需要一个值。

标志

--frozen

lingo.dev i18n --frozen

验证翻译是否为最新状态且不做更改——如果源文件、目标文件或锁文件不同步则失败。非常适合在 CI/CD 流程中用于部署前确保翻译一致性

--force

lingo.dev i18n --force

强制重新翻译所有 key,跳过变更检测。当你需要用更新的 AI 模型或翻译设置重新生成翻译时非常有用

--verbose

lingo.dev i18n --verbose

以格式化 JSON 形式打印每个 bucket 和 locale 正在处理的翻译数据

--interactive

lingo.dev i18n --interactive

在应用更改到文件前,交互式地审查和编辑 AI 生成的翻译

--debug

lingo.dev i18n --debug

在处理本地化前暂停,以便你可以附加调试器

--strict

lingo.dev i18n --strict

遇到第一个错误时立即停止,而不是继续处理剩余的 bucket 和 locale(快速失败模式)