# gt: General Translation CLI tool: 下载
URL: https://generaltranslation.com/zh/docs/cli/download.mdx
---
title: 下载
description: 如何下载先前已加入翻译队列或已暂存的翻译
---

## 用法

```bash
npx gt download
```

<Callout type="info">
  **注意：** 此命令需要生产环境 API 密钥！请在
  [平台](https://generaltranslation.com/dashboard)
  获取。
</Callout>


## 概述

`gt download` 命令用于下载已完成的翻译；这些内容此前已通过 [`gt enqueue`](/docs/cli/enqueue) 或 [`gt stage`](/docs/cli/stage) 提交进行翻译。

典型工作流程如下：

1. [`gt upload`](/docs/cli/upload) — 将源文件上传到 General Translation 平台
2. [`gt enqueue`](/docs/cli/enqueue) — 将已上传的文件加入翻译队列
3. **`gt download`** — 下载已完成的翻译

这种拆分方式在 CI/CD 流水线中特别有用，因为每个步骤都可以在不同的阶段或作业中执行。

<Callout type="warn">
  **仅限生产环境使用！**

  此命令用于生产构建，**不应在开发环境中使用**。
  请记得在环境变量中指定生产环境 API 密钥 (`GT_API_KEY`) 和项目 ID (`GT_PROJECT_ID`) 。
</Callout>

## 工作方式

1. 读取你的 `gt.config.json`，确定文件配置
2. 如果启用了 `stageTranslations`，则读取暂存版本数据；否则会收集并计算文件哈希，以确定需要下载哪些内容
3. 轮询 General Translation API，检查翻译是否已完成
4. 将翻译文件下载并保存到配置中指定的输出路径

## 标志

`download` 命令接受与 [`translate`](/docs/cli/translate#flags) 相同的标志。

| 参数                | 说明                  | 类型       | 可选     | 默认值                |
| ----------------- | ------------------- | -------- | ------ | ------------------ |
| `--api-key`       | 指定生产环境 API 密钥       | `string` | `true` |                    |
| `--project-id`    | 指定项目 ID             | `string` | `true` |                    |
| `--version-id`    | 指定版本 ID (默认是内容的哈希值) | `string` | `true` |                    |
| `--config <path>` | 指定 GT 配置文件的路径       | `string` | `true` | `"gt.config.json"` |

| `--timeout`                     | 请求超时时间 (秒)               | `number`   | `true` | `900`              |
| `--new, --locales <locales>`    | 要将项目翻译到哪些区域设置            | `[string]` | `true` |                    |
| `--default-locale <locale>`     | 项目的源区域设置                 | `string`   | `true` | `en`               |
| `--dry-run`                     | 试运行该命令                   | `flag`     | `true` | `false`            |
| `--force`                       | 强制下载所有翻译，并覆盖本地更改         | `flag`     | `true` | `false`            |
| `--force-download`              | 强制下载所有翻译，并覆盖本地更改         | `flag`     | `true` | `false`            |

## 示例：拆分 CI 流程

```bash
# 阶段 1：上传源文件
npx gt upload

# 阶段 2：将翻译加入队列
npx gt enqueue

# 阶段 3：准备就绪后下载
npx gt download
```