lingo init

创建本地化配置,明确指定源语言区域、目标语言区域和资源目录路径。

lingo init 会将本地化设置写入 .lingo/config.json。当项目需要首次配置源语言区域、目标语言区域列表和文件匹配模式时,可使用此命令。源文件、凭据和本地化引擎绑定需单独处理:初始化不会创建或翻译这些资源。

sh
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 的自定义设置。更改资源目录路径不会自动更改翻译文件的匹配模式。

首个文件操作指南会接着介绍配置之后的首次补译和目标文件获取流程。有关高级文件条目的参考说明,请参阅配置。