# gt: General Translation CLI tool: gt validate
URL: https://generaltranslation.com/ja/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 ファイル (`--dictionary` が設定されていない場合は、`./` または `./src` の `dictionary.[js|json|ts]`) を解析し、構文が正しいかを確認します。

`validate` は General Translation API を呼び出さないため、開発中や CI を含め、いつでも安全に実行できます。

## 出力 [#outputs]

* **警告** — スキャン中に見つかった致命的ではない問題の件数と一覧を出力します。警告だけではコマンドは失敗しません。
* **エラー** — 構文エラーの件数と一覧を出力したうえで、ゼロ以外のステータスコードで終了します。そのため、`validate` は CI のゲートとして有効です。
* **概要** — 成功時には、見つかった翻訳可能なエントリ数を報告します。1 件も見つからなかった場合は、インラインコンテンツまたは辞書が検出されなかったことを報告します。

## フラグ [#flags]

| パラメータ                           | 説明                           | 型          | 任意 | デフォルト                                        |
| ------------------------------- | ---------------------------- | ---------- | -- | -------------------------------------------- |
| `-c, --config <path>`           | config ファイルへのパス。             | `string`   | はい | `gt.config.json`                             |
| `--src <paths...>`              | ソースファイルの glob パターン。          | `string[]` | はい | `src`、`app`、`pages`、`components` の glob パターン |
| `--dictionary <path>`           | dictionary ファイルへのパス。         | `string`   | はい | —                                            |
| `--tsconfig, --jsconfig <path>` | TS または JS の config ファイルへのパス。 | `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` を実行してください。エラー時は非ゼロ終了コードを返すため、ビルドは失敗します。