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

title: gt validate
description: 在不调用 API 的情况下检查 General Translation 项目中的翻译错误。gt validate 命令的 API 参考。

---

扫描项目中的内联内容——例如 [`<T>`](/docs/react/reference/components/t) 组件和 [`useGT`](/docs/react/reference/hooks/use-gt) 调用——以及词典条目，然后检查可能导致翻译无法成功完成的问题。它不会调用 General Translation API，因此可随时安全运行，包括在开发和 CI 环境中。

由于它在出现错误时会以非零状态码退出，因此非常适合作为 CI 检查项。

*注意：适用于框架和内联库——`gt-next`、`gt-react`、`gt-react-native`、`gt-tanstack-start`、`gt-node`、`gt-flask` 和 `gt-fastapi`。基础 (非框架) 项目不会注册此命令。*

可验证整个项目，也可传入文件路径，仅验证这些文件。

```bash
npx gt validate
npx gt validate src/components/Header.tsx src/pages/Home.tsx
```

## 它会检查什么 [#checks]

* 你 `src` glob 中的 **内联内容** —— `<T>` 组件、`useGT`/[`useTranslations`](/docs/react/reference/hooks/use-translations) 调用，以及其他内联翻译模式 —— 是否存在会导致翻译出错的语法问题。
* **词典条目** —— 解析你的词典文件 (未设置 `--dictionary` 时，会在 `./` 或 `./src` 中查找 `dictionary.[js|json|ts]`) ，以检查语法是否正确。

`validate` 绝不会调用 General Translation API，因此你可以随时安全运行它，包括在开发环境和 CI 中。

## 输出 [#outputs]

* **警告** — 记录扫描时发现的非致命问题的数量及列表。仅有警告不会导致命令失败。
* **错误** — 记录语法错误的数量及列表，然后以非零状态码退出。这也是 `validate` 之所以能作为实用的 CI 门禁。
* **摘要** — 成功时，会报告找到的可翻译条目数；如果一个都没找到，则会报告未检测到任何内联内容或字典。

## 标志 [#flags]

| 参数                              | 描述                      | 类型         | 可选 | 默认值                                     |
| ------------------------------- | ----------------------- | ---------- | -- | --------------------------------------- |
| `-c, --config <path>`           | config file 的路径。        | `string`   | 是  | `gt.config.json`                        |
| `--src <paths...>`              | source files 的 Glob 模式。 | `string[]` | 是  | `src`、`app`、`pages`、`components` 的 glob |
| `--dictionary <path>`           | 词典文件 的路径。    | `string`   | 是  | —                                       |
| `--tsconfig, --jsconfig <path>` | TS 或 JS 配置文件的路径。        | `string`   | 是  | 自动检测                                    |
| `--inline`                      | 在验证中包含内联内容。             | `boolean`  | 是  | `true`                                  |

## 示例 [#example]

```bash
# 验证整个项目
npx gt validate

# 仅验证特定文件
npx gt validate src/components/Header.tsx src/pages/Home.tsx
```

## 其他说明 [#notes]

传入 `[files...]` 时，只会验证这些文件，而非整个项目。请在 CI 中于 [`gt translate`](/docs/cli/reference/commands/translate) 之前运行 `validate`，以便尽早发现语法错误——如果出现错误，它会返回非零退出码，从而导致构建失败。