CLI

翻译项目文件、获取翻译结果,并维护 React 应用使用的源语言消息目录。

Lingo.dev CLI 将项目文件与本地化引擎连接起来。配置源文件路径和目标语言后,即可推送所选内容并获取翻译后的文件。后续运行会以已记录的源内容基线为依据,处理内容变更。

@lingo.dev/cli 会安装 lingo 可执行程序。从你的第一个文件开始,了解完整的配置与结果获取流程。

安装当前版本的 @lingo.dev/cli,并使用 lingo --version 记录项目使用的版本。对于 lingo.dev@0.138.10 及其 i18n.json 项目,请参阅 CLI v0 参考。

选择适合你的安装方式 #

如需作为项目依赖安装并纳入版本控制:

sh
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --version

如需安装可在命令行环境中全局使用的可执行程序:

sh
npm install --global @lingo.dev/cli
lingo --help

本手册直接使用 lingo。如果采用本地安装,请通过包管理器调用。npx @lingo.dev/cli@latest 和 pnpm dlx @lingo.dev/cli@latest 无需持久安装即可运行最新版本。如需确保本地与 CI 的行为一致,请固定版本;CI 示例使用 Node.js 22。

lingo update 会使用检测到的安装方式。如需指定版本,或当前安装方式无法识别或仅为临时安装,请使用包管理器。

翻译文件或提取消息 #

对于现有资源,请先配置文件,完成身份验证并关联本地化引擎。翻译在服务器端执行。push --wait 会等待翻译完成并下载结果;也可以分别使用 push 和 pull,稍后再获取结果。

对于 React 源代码中的调用,提取会在本地生成 JSONC 和 TypeScript 声明,但不会执行翻译或安装运行时。将提取的消息目录加入文件配置以进行翻译,再通过 React 的消息目录工作流加载。

保留后续更新所需的状态 #

首次普通推送会存储源内容的字节数据。回填会创建缺失的目标文件;后续普通推送则会翻译源内容的变更。请将 .lingo/config.json、.lingo/lock.json 和已接受的翻译一同纳入版本控制。凭据和最近一次运行的指针仍保存在你的主目录中。

推送、拉取和 Lockfile 与缓存介绍了可选的模式与恢复方式。命令列出了配置、翻译和消息目录维护命令。