快速上手 · Lingo.dev

不到 5 分钟，快速上手 CLI。

准备事项

请先确认你已安装 Node.js 18.0 或更高版本。运行 node --version 检查即可。

安装#

使用你常用的包管理器全局安装 CLI：

bash

npm install -g lingo.dev

验证安装#

确认 CLI 已正确安装：

bash

lingo --version

你应该会看到类似这样的输出：

plaintext

lingo.dev v0.133.9
Node.js v20.10.0

初始化项目#

进入项目目录并运行：

bash

cd my-project
lingo init

这个交互式命令会帮助你：

连接到账户 - 使用 API 密钥完成身份验证
选择项目 - 选择现有项目或创建新项目
配置语言 - 选择需要支持的语言
设置文件结构 - 选择翻译文件的存放位置

配置已创建

CLI 会创建一个 i18n.json 文件来保存你的配置。后续你也可以按需修改。

第一次翻译#

创建一个简单的翻译文件：

json

{
  "welcome": {
    "title": "Welcome to Lingo.dev",
    "subtitle": "The Localization Engineering Platform"
  },
  "auth": {
    "login": "Log in",
    "logout": "Log out"
  }
}

运行翻译#

将内容翻译到所有已配置的目标语言：

bash

lingo run

CLI 会自动：

✅ 识别源文件
✅ 计算与 lockfile 的差异
✅ 将变更内容发送到你的翻译后端
✅ 将翻译结果写入磁盘

监视模式（开发）#

在日常开发中，你可以开启监视模式，在源文件变更时自动重新翻译：

bash

lingo run --watch

按下 Ctrl+C 退出监视模式。

获取帮助#

需要帮助？

bash

# Show help for all commands
lingo --help

# Show help for a specific command
lingo run --help

加入我们的 Discord community，获取实时支持！

下一步#