lingo init
创建本地化配置,明确指定源语言区域、目标语言区域和资源目录路径。
lingo init 会将本地化设置写入 .lingo/config.json。当项目需要首次配置源语言区域、目标语言区域列表和文件匹配模式时,可使用此命令。源文件、凭据和本地化引擎绑定需单独处理:初始化不会创建或翻译这些资源。
lingo init --source en --targets de,fr --files 'locales/en.json,docs/en/**/*.md' --yes打开生成的文件,确认它只匹配预期的源内容。然后按需创建这些文件,登录,并在远程翻译前运行 link。
选项 #
| 选项 | 默认值或作用 |
|---|---|
--source <locale> | 接受默认值时为 en。 |
--targets <list> | 以逗号分隔的语言区域;使用 --yes 时为 de,fr,es。 |
--files <list> | 用逗号分隔的模式:locales/<source>.json 配合 --yes 使用,例如 locales/en.json。 |
--messages-path <path> | 设置 React 目录 i18n.messagesPath;默认为 locales。 |
--types-path <path> | 设置声明 i18n.typesPath;默认为 lingo.d.ts。 |
--force | 替换现有本地化设置。 |
--no-agents-md | 跳过 AGENTS.md 和 CLAUDE.md 中的 Lingo.dev 区块。 |
--yes, -y | 使用提供的值或默认值,不显示交互提示。 |
未使用 --yes 时,系统会提示你补全尚未指定的选项。列表会按逗号和空格拆分,因此要添加包含空格的模式,请直接编辑 .lingo/config.json。重复的目标语言区域和与源语言区域完全相同的项会被移除。若处理后的目标列表为空,系统将不予接受。请用引号括起模式,避免命令行解释器在 CLI 接收这些模式前将其展开。
初始化还会在项目的 AGENTS.md 中写入一个 Lingo.dev 区块,文件不存在时会自动创建;同时也会将该区块写入已有的 CLAUDE.md,除非它导入了一个承载该区块的 AGENTS.md。该区块会指示编程代理在开始本地化工作前运行 npx @lingo.dev/cli agent-guide。区块标记之外的文本会保留,后续运行时只会替换标记之间的文本。
重新初始化现有项目 #
不使用强制选项时,现有本地化配置会保留,初始化会失败,不会覆盖配置。使用强制选项时,命令会根据匹配模式重建 files[]。排除项、显式格式、输出模板和键控制等高级条目选项会丢失。请在使用强制选项前保存这些设置;如果只需小幅调整,可直接编辑现有配置。
其他顶层部分会保留,包括组织与本地化引擎的绑定。保存的配置会省略资源目录路径的默认值;使用强制选项恢复默认值时,可能会清除先前对 i18n 的自定义设置。更改资源目录路径不会自动更改翻译文件的匹配模式。