# @crowdin/cli 中文文档

规范地址：https://npmcn.com/package/%40crowdin/cli/

版本：5\.6\.0
npm 元数据更新时间：2026-11-05T08:17:36.623Z
中文译文更新时间：2026-11-11T01:47:10.425Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40crowdin/cli
原文对照：https://npmcn.com/package/%40crowdin/cli/?lang=original
项目主页：https://crowdin.github.io/crowdin-cli
源码仓库：https://github.com/crowdin/crowdin-cli

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：5.6 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2020-09-23T15:47:49.065Z
- 最新版本发布：2026-11-05T08:17:36.341Z
- 近 30 天下载量：850109（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：95（近 12 个月 25 个）

## 中文简介

Crowdin CLI 是一个命令行工具,允许您管理和同步您的 Crowdin 工程本地化资源

## 安装

```sh
npm install @crowdin/cli
```

也可以使用：`pnpm add @crowdin/cli`、`yarn add @crowdin/cli`、`bun add @crowdin/cli`

## README

# 克罗丁CLI

Crowdin CLI是一个命令行工具,允许您管理和同步您的 Crowdin 项目本地化资源 :

-   自动更新 Crowdin 项目中的源文件
-   从 Crowdin 下载翻译并自动保存在正确的位置
-   以分钟内上传您所有的翻译
-   在不离开终端的情况下管理您的本地化资源
-   将本地化纳入您的 CI/CD 管道

CLI飞船是每个平台的本土自成一体的二进制船 -- -- 没有其他东西可以安装、即时起动,在交互式终端或CI作业中同样在家.

## 安装

```
npm i -g @crowdin/cli
```

npm自动安装匹配您的平台的二进制(macOS arm64/x64,Linux x64/arm64 glibc & musl,Windows x64/arm64). 其他选项—— Homebrew, Coocloy, Docker, 独立二进制—— 包含在 [安装指南](https://crowdin.github.io/crowdin-cli/installation)。 。 。 .

## 开始

交互向导在浏览器中授权 CLI , 并带您到一个准备中 `crowdin.yml` 配置 :

```bash
crowdin init
```

然后同步您的本地化资源 :

```bash
# upload source files to Crowdin
crowdin upload sources

# upload existing translations
crowdin upload translations

# download the latest translations
crowdin download
```

添加 `--dry-run` 预览命令会做什么,以及 `-h` 以选择任何命令.

## 脚本和自动化

全球 `-o, --output` 选项将任何命令切换到机器可读输出 : `json` (把它导入) `jq`, (中文(简体) ), `toon` (单位:千美元)[指向对象符号](https://github.com/toon-format/toon) - 与LLM和代理工作流程相适应的紧凑形式数据,或 `plain`结合稳定的退出代码,这使得CLI易于从脚本,CI管道和AI代理驱动.

## 壳完成

Crowdin CLI号舰 `zsh`, (中文(简体) ), `bash`, (中文(简体) ), `fish`,以及 `powershell` - 看这个 [自动补全指南](https://crowdin.github.io/crowdin-cli/autocompletion) 让你的贝壳能够使用.

## 文档

-   [Crowdin CLI 文档](https://crowdin.github.io/crowdin-cli)
-   [配置文件引用](https://crowdin.github.io/crowdin-cli/configuration)
-   [报告问题](https://github.com/crowdin/crowdin-cli/issues)

## 许可证

麻省理工学院

## 常见问题

### @crowdin/cli 是什么？

Crowdin CLI 是一个命令行工具,允许您管理和同步您的 Crowdin 工程本地化资源

### 如何安装 @crowdin/cli？

在项目目录运行 npm install @crowdin/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 crowdin，可以用 npx crowdin 直接运行。

### @crowdin/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/crowdin\_\_cli 是否存在。

### @crowdin/cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @crowdin/cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @crowdin/cli 可以商用吗？

@crowdin/cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @crowdin/cli 的下载量有多少？

根据 npm 官方下载统计，@crowdin/cli 在 2026/10/11 – 2026/11/09 这 30 天内被下载 850,109 次，日均约 28,337 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @crowdin/cli 还在维护吗？

最新版本 5\.6\.0 发布于 2026/11/05（5 天前）；至今共发布 95 个版本，其中过去 12 个月发布了 25 个；首次发布于 2020/09/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。