# gt: General Translation CLI tool: GT JSX
URL: https://generaltranslation.com/zh/docs/cli/formats/gt.mdx
---
title: GT JSX
description: 自动翻译你的 gt-next、gt-react 或 gt-react-native 项目
---

## 概述

本教程将向你演示如何在使用 [`gt-next`](/docs/next)、[`gt-react`](/docs/react) 或 [`gt-react-native`](/docs/react-native) 时，自动管理项目的翻译文件。

<Callout type="warn">
  **注意：** 仅应在发布生产构建时使用此功能。
  如果你是在开发环境中使用 gt-next、gt-react 或 gt-react-native，则不需要这个
  命令。
</Callout>

我们将按以下 3 个步骤进行：

<Steps>
  <Step>添加环境变量</Step>

  <Step>
    使用 [`npx gt
        configure`](/docs/cli/configure) 命令配置项目
  </Step>

  <Step>运行 [`gt translate`](/docs/cli/translate#translate)</Step>
</Steps>

***

## 第 1 步：添加环境变量

将生产环境 API 密钥和项目 ID 添加到环境变量中。
这是使用 `gt` 工具的必要步骤。
你可以在 [General Translation 仪表板](https://generaltranslation.com/dashboard) 获取这些信息。

```bash title=".env"
GT_API_KEY=<your-api-key>
GT_PROJECT_ID=<your-project-id>
```


## 第 2 步：使用 `npx gt configure` 命令配置项目

运行 `gt configure` 命令来配置项目。

```bash
npx gt configure
```


## 第 3 步：将 `gt translate` 命令添加到构建流程中

在执行构建命令之前，将 `gt translate` 命令添加到你的构建或 CI 流程中，以便自动将翻译加入项目。

```json title="package.json"
{
  "scripts": {
    "translate": "npx gt translate",
    "build": "npm run translate && <your build command>"
  }
}
```

这会为你的所有区域设置生成翻译，并将其保存到项目中。
如果你想把这些文件提交到代码仓库，也可以改为在提交前运行此命令。

完成了！现在，每当项目发生变化时，它都会自动更新所有翻译 JSON 文件。

***


## 说明

* 你可以使用 [`gt translate`](/docs/cli/translate#translate) 命令自动将翻译添加到项目中。
* 如果你想提交翻译文件，也可以改为在提交前运行 `gt translate` 命令。
* 要配置翻译的输出路径，请参阅[配置](/docs/cli/reference/config)文档。

## 后续步骤

* 请参阅 [translate 命令](/docs/cli/translate)了解 CLI 的使用详情。