快速开始
已弃用
这些文档介绍的是旧版 CLI（v0）。当前 CLI 版本为 v1。 查看当前 CLI 文档
安装 Lingo.dev CLI，完成项目配置，并生成第一批译文。
准备工作
需要 Node.js 18 或更高版本。运行 node -v 检查当前版本。
第 1 步：初始化项目#
1
进入项目目录
bash
cd your-project-directory2
运行 init 命令
bash
npx lingo.dev@latest init**Windows 用户：**如果 npx lingo.dev 无法运行，请先用 npm install lingo.dev@latest 安装该软件包，再改用 npx lingo。
按提示操作即可。CLI 会在项目根目录下创建一个 i18n.json 配置文件。
第 2 步：配置 bucket#
在 i18n.json 中，至少配置一个 bucket——也就是文件格式与 include 模式的组合，用来告诉 CLI 哪些位置包含可翻译内容：
json
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["locales/[locale].json"]
}
}
}[locale] 占位符会在运行时解析为你配置的 locale 代码——源语言对应 locales/en.json，西班牙语对应 locales/es.json，以此类推。
如需查看所有支持的文件格式及对应的 bucket 配置，请参阅 Supported Formats。
第 3 步：连接翻译后端#
CLI 需要连接翻译后端才能生成译文。你有两种选择：
第 4 步：生成译文#
bash
npx lingo.dev@latest runCLI 会自动发现源文件、提取可翻译内容、发送到你配置的翻译后端，并将结果写回磁盘。系统还会创建一个 i18n.lock 文件，用于跟踪已翻译内容——请将它与 locale 文件一并提交。