不到 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 runCLI 会自动:
- ✅ 识别源文件
- ✅ 计算与 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,获取实时支持!
