# gt: General Translation CLI tool: 验证
URL: https://generaltranslation.com/zh/docs/cli/validate.mdx
---
title: 验证
description: 如何检查项目中的翻译错误
---

## 用法

```bash
npx gt validate
```

## 概述

`gt validate` 命令会扫描项目中的内联内容 (例如 `<T>` 组件和 `useGT` 钩子) 以及词典条目，然后检查是否存在语法错误或其他会导致翻译无法成功进行的问题。

与 [`gt translate`](/docs/cli/translate) 不同，此命令**不会**与 General Translation API 通信。它只执行本地验证，因此可以随时安全运行——无论是在开发环境中、在 CI 中，还是在生产构建之前。

<Callout type="info">
  此命令适用于使用 [`gt-next`](/docs/next)、[`gt-react`](/docs/react)、[`gt-react-native`](/docs/react-native) 或 [`gt-tanstack-start`](/docs/tanstack-start) 的项目。
</Callout>

### 验证整个项目 [#validate-project]

```bash
npx gt validate
```

这会扫描你的源目录和字典文件 (如果已配置) 中的可翻译内容，并报告发现的任何错误或警告。

### 验证指定文件 [#validate-files]

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

你可以将一个或多个文件路径作为参数传入，这样就只会验证这些文件，而不是整个项目。

## 检查内容

* **内联内容：** 扫描源文件中的 `<T>` 组件、`useGT` 钩子及其他内联翻译模式。
* **字典条目：** 验证字典文件的语法是否正确。
* **语法错误：** 报告任何会导致 `gt translate` 或 `gt stage` 失败的问题。

如果验证成功，你会看到类似下面的摘要：

```
Success! Found 12 translatable entries for gt-next.
```

如果有错误，该命令会列出这些错误，并以非零状态码退出，因此适合在 CI 流水线中使用。

***

## 标志

| 参数                              | 说明                         | 类型         | 可选     | 默认值                                                                                                                         |
| ------------------------------- | -------------------------- | ---------- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| `-c, --config <path>`           | 指定 GT config file 的路径      | `string`   | `true` | `"gt.config.json"`                                                                                                          |
| `--tsconfig, --jsconfig <path>` | 指定 TS 或 JS config file 的路径 | `string`   | `true` |                                                                                                                             |
| `--dictionary <path>`           | 指定字典文件的路径                  | `string`   | `true` |                                                                                                                             |
| `--src <paths>`                 | 用空格分隔的 glob 模式列表，用于匹配源文件   | `[string]` | `true` | `['src/**/*.{js,jsx,ts,tsx}', 'app/**/*.{js,jsx,ts,tsx}', 'pages/**/*.{js,jsx,ts,tsx}', 'components/**/*.{js,jsx,ts,tsx}']` |
| `--inline`                      | 在验证时包含内联内容                 | `boolean`  | `true` | `true`                                                                                                                      |

以上所有参数均为可选。