# gt: General Translation CLI tool: 検証
URL: https://generaltranslation.com/ja/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
```

ソースディレクトリと dictionary ファイル (設定されている場合) をスキャンし、翻訳対象のコンテンツを検出して、エラーや警告を報告します。

### 特定のファイルを検証する [#validate-files]

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

プロジェクト全体ではなく、対象のファイルだけを検証するには、1 つ以上のファイルパスを引数として渡します。

## チェック対象

* **インラインコンテンツ:** ソースファイル内の`<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>`           | dictionary file へのパスを指定します           | `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`                                                                                                                      |

これらのパラメータはすべて省略可能です。