# gt: General Translation CLI tool: gt init
URL: https://generaltranslation.com/zh/docs/cli/reference/commands/init.mdx
---

title: gt init
description: 运行 General Translation 的设置向导来配置项目。gt init 命令的 API 参考。

---

运行设置向导，为项目完成 General Translation 的初始化。这是默认命令——直接运行 `npx gt` (不带任何命令) 时，会执行 `init`。

该向导会检测你的框架，并根据项目情况安装依赖、配置框架、创建 `gt.config.json`，以及生成凭据。有关详细步骤，请参阅[配置 CLI](/docs/cli/guides/configuring)。

```bash
npx gt init
```

## 工作方式 [#how-it-works]

1. 检测你的框架。对于 Next.js App Router 或 Mintlify 项目，它会改为提示你连接 [Locadex](/docs/platform/locadex/quickstart) AI 智能体。
2. 对于基于 React 的项目，可选择安装 `gt-react` 或 `gt-next`，并添加 `GTProvider` (实验性) 。
3. 提示你输入默认区域设置和目标区域设置，并创建 `gt.config.json`。如果使用本地存储，还会创建一个 [`loadTranslations`](/docs/react/reference/functions/load-translations) 文件。
4. 如果尚未安装，它会将 `gt` 安装为开发依赖。
5. 可选择生成 API 密钥和项目 ID，并将其写入 `.env.local`。

*注意：React 设置步骤仍处于实验阶段，可能不适用于所有项目。请检查它所做的更改。*

## 标志 [#flags]

| 参数                    | 描述               | 类型         | 可选 | 默认值                                        |
| --------------------- | ---------------- | ---------- | -- | ------------------------------------------ |
| `--src <paths...>`    | 应用源码的 Glob 模式。   | `string[]` | 是  | `src`、`app`、`pages`、`components` 的 glob 模式 |
| `-c, --config <path>` | config file 的路径。 | `string`   | 是  | `gt.config.json`                           |

## 示例 [#example]

```bash
# 运行完整的设置向导
npx gt init

# 不带任何命令运行 gt 效果相同
npx gt
```

## 其他说明 [#notes]

* `init` 会执行与 [`gt configure`](/docs/cli/reference/commands/configure) 和 [`gt auth`](/docs/cli/reference/commands/auth) 相同的步骤，另外还会运行实验性的 React 设置向导。若只想重做其中某一步，请单独运行对应命令。它不会运行 [`gt setup`](/docs/cli/reference/commands/setup)，该命令会上传你的源文件。
* 使用 `gt-react` 或 `gt-next` 不需要 API 密钥和项目 ID——只有在调用 General Translation API 时才需要它们。
* 如果实验性的 React 设置不适用于你的项目，请参照 [React](/docs/react/react-quickstart) 文档手动进行设置。