翻译你的第一个文件
创建源语言资源清单,获取德语和法语目标文件,再翻译后续的源内容变更。
本教程将以一个英文 JSON 文件为例,带你走完设置、翻译和获取文件的完整流程。完成后,目标语言文件会保存到磁盘,并为后续修改建立基准。如需让编程智能体代为完成设置,请参阅使用编程智能体进行设置。
准备一个小型项目目录,并确保 Node.js 和 npm 可用。你还需要一个 Lingo.dev 账户、使用已启用的本地化引擎进行翻译的权限,以及足以完成本次翻译的账户额度。
安装并登录 #
npm install --global @lingo.dev/cli
lingo --version
lingo login登录时会打开浏览器。如果使用非交互式运行环境,请改为通过该环境的密钥存储提供 LINGO_API_KEY。环境变量中的密钥会覆盖已保存的登录凭据,因此,在以其他用户身份登录前,请移除无意中设置的密钥覆盖项。
创建源文件 #
创建一个 locales 目录,并将以下内容保存为 locales/en.json:
{
"checkout": {
"title": "Review your order",
"submit": "Place order"
}
}在项目根目录运行:
lingo init --source en --targets de,fr --files 'locales/en.json' --yes
lingo linkinit 会写入 .lingo/config.json,并在 AGENTS.md 中添加一个 Lingo.dev 区块,提示编程智能体阅读 CLI 的智能体指南;传入 --no-agents-md 即可跳过此操作。通过 link,你可以选择组织和本地化引擎,也可以在权限允许的情况下创建它们。本地化引擎提供模型和语言指导;引擎 ID 保存在项目配置中,你的凭据则单独保存。
继续之前,请打开配置,确认其中将 en 设为源语言,de 和 fr 设为目标语言,locales/en.json 设为源文件。同时检查组织和本地化引擎的 ID,尤其是在复制或派生的项目中。
翻译并获取结果 #
lingo push --backfill-missing --wait补全操作会为缺失的目标文件发起翻译请求。--wait 会等待翻译完成并下载结果。如果没有 Lockfile,首次普通推送只会建立源内容存储,而不会发起这次初始翻译。
命令等待期间,请勿修改目标文件:这种直接获取结果的方式不会像单独的拉取命令那样,重新比对本地修改以检测冲突。如果运行正在等待审核或报告了失败,请先检查其状态,不要直接将其视为已完成。
打开 locales/de.json 和 locales/fr.json,确认两个 checkout 键都仍然存在,并查看翻译后的值。如果你无法评判某个目标语言的翻译,请交由合格的审核者检查,或使用适用的评测方式。与应用程序集成时,还应通过应用程序正常使用的资源加载器加载这些文件。
对照源文件与目标文件的差异,审核 .lingo/lock.json。将审核通过的文件、配置和基线一起提交。如果未使用 --wait,请稍后在同一台机器的同一个 checkout 中运行 lingo pull,获取本地记录的最新一次运行结果。
更新源文件 #
在 locales/en.json 中修改一个值或添加一个键,然后运行:
lingo push --wait常规更新会将源内容变更与已保存的基线进行比较。补全操作用于补齐缺失的文件,而不是为已有的目标文件补充新键。
如需使用其他资源类型或目录结构,请参阅配置和格式。YAML 和 Android XML 需要明确指定格式。如需从 React 源代码调用中提取内容,请继续阅读 React 快速入门,并在配置中选择其 JSONC 资源清单,不要假定本教程中的 JSON 示例会自动选择该清单。