持续本地化

Lingo.dev 让翻译始终与代码保持同步。每次代码变更时，它都会识别发生变化的内容，通过你已连接的 本地化引擎 完成翻译——一致应用术语表规则、品牌语调和按语言区域配置的模型设置——然后提交结果或创建拉取请求。未完成的翻译绝不会进入生产环境。

选择适合你的集成方式#

每种集成方式都有对应的使用指南。请选择与你当前环境匹配的方案：

GitHub App 运行在 Lingo.dev 的服务器上。除此之外，其他集成都通过 Lingo.dev CLI 运行——这意味着任何支持 Node.js 22+ 的 CI/CD 环境，即使没有官方集成，也能直接执行本地化。

GitHub App 如何工作#

安装应用一次，并在仓库中添加一个 .lingo/config.json。从此以后，Lingo.dev 就会自动为你运行本地化——无需流水线、无需 API 密钥 secret、无需 lockfile：

1. 监测变更 —— 默认开箱即用地响应默认分支上的 push；启用 onPullRequest 后，也会响应拉取请求，并根据你配置的源文件模式检查变更文件
2. 翻译增量内容 —— 将变更后的源内容发送到由 engineId 指定的引擎进行翻译
3. 将结果写回 GitHub —— 在默认分支 push 时，它会创建或更新翻译拉取请求；在拉取请求中，它会把翻译后的文件提交到 PR 分支，并发布状态评论
4. 补漏与分批处理 —— 检测先前运行遗漏的变更，并将超大更新拆分为多个提交

你可以通过审批步骤来控制运行，也可以在拉取请求中使用 /lingo 命令手动触发翻译。完整配置请参阅 GitHub App 指南。

CLI 集成如何工作#

GitHub Actions、GitLab CI/CD 和 Bitbucket 集成都在现有流水线的某个步骤中运行同一个 Lingo.dev CLI。它们需要两样东西：你的 .lingo/config.json 配置文件，以及一个用于身份验证的 LINGO_API_KEY。

每次运行时，任务都会安装 CLI（npm install -g @lingo.dev/cli），并执行 lingo push，其作用包括：

1. 发现源文件 —— 读取你的 bucket 配置，找到可翻译内容
2. 检测变更 - 对比 .lingo/lock.json 锁定文件，识别新增或修改的字符串，因此只有增量内容会被翻译。
3. 执行翻译 —— 通过你配置的 本地化引擎 处理变更内容，并应用所有规则——包括术语表、品牌语调和按语言区域设置的模型参数
4. 写入结果 - 直接更新目标语言环境文件，并刷新 .lingo/lock.json。

随后，你的流水线会使用平台自带的工具提交结果，或发起拉取请求。由于只翻译发生变更的字符串，因此运行速度快、成本也更可控——即使覆盖数十种语言环境也是如此。

工作流选项#

GitHub App#

应用的行为通过 .lingo/config.json 配置：

完整配置和命令参考请参阅 GitHub App 指南。

CI/CD 中的 CLI（GitHub Actions、GitLab CI、Bitbucket）#

四种工作流模式已覆盖大多数团队的使用场景：

第一种方式——提交到 main——最简单。翻译会自动出现，开发者零干预。基于 PR 的方案则会在翻译合入前增加一个审核步骤。

如需了解如何在这些方案之间做选择，请参阅 高级模式。

下一步#