# gt: General Translation CLI tool: gt validate
URL: https://generaltranslation.com/ru/docs/cli/reference/commands/validate.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Проверка проекта General Translation на ошибки перевода без вызова API. Справочник API для команды `gt validate`.

Сканирует ваш проект на наличие встроенного контента — например, компонентов [`<T>`](/docs/react/reference/components/t) и вызовов [`useGT`](/docs/react/reference/hooks/use-gt) — а также записей словаря, а затем выявляет проблемы, которые могут помешать успешному переводу. Команда не вызывает API General Translation, поэтому её можно безопасно запускать в любое время, в том числе во время разработки и в CI.

Поскольку при ошибках она завершается с ненулевым кодом завершения, она хорошо подходит для проверок в CI.

*Примечание: Доступно для framework- и inline-библиотек — `gt-next`, `gt-react`, `gt-react-native`, `gt-tanstack-start`, `gt-node`, `gt-flask` и `gt-fastapi`. Для базовых проектов (без framework) команда не регистрируется.*

Проверьте весь проект или передайте пути к файлам, чтобы проверить только их.

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

## Что он проверяет [#checks]

* **Встроенный контент** в ваших glob-шаблонах `src` — компоненты [`<T>`](/docs/react/reference/components/t), вызовы [`useGT`](/docs/react/reference/hooks/use-gt)/[`useTranslations`](/docs/react/reference/hooks/use-translations) и другие встроенные шаблоны перевода — на наличие синтаксических ошибок, которые могут сломать перевод.
* **Записи словаря** — разбирает ваш файл словаря (он находится по пути `dictionary.[js|json|ts]` в `./` или `./src`, если `--dictionary` не задан), чтобы проверить корректность синтаксиса.

`validate` никогда не вызывает API General Translation, поэтому его безопасно запускать в любое время, в том числе во время разработки и в CI.

## Результаты [#outputs]

* **Предупреждения** — выводит количество и список некритичных проблем, обнаруженных при сканировании. Сами по себе предупреждения не приводят к сбою команды.
* **Ошибки** — выводит количество и список синтаксических ошибок, а затем завершает работу с ненулевым кодом состояния. Именно это делает `validate` полезной проверкой в CI.
* **Сводка** — при успешном выполнении сообщает количество найденных переводимых записей; если ничего не найдено, сообщает, что встроенный контент или словари не обнаружены.

## Флаги [#flags]

| Параметр                        | Описание                                | Тип        | Необязателен | По умолчанию                                     |
| ------------------------------- | --------------------------------------- | ---------- | ------------ | ------------------------------------------------ |
| `-c, --config <path>`           | Путь к конфигурационному файлу.         | `string`   | Да           | `gt.config.json`                                 |
| `--src <paths...>`              | Glob-шаблоны для исходных файлов.       | `string[]` | Да           | glob-шаблоны `src`, `app`, `pages`, `components` |
| `--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...]`, будут проверены только эти файлы, а не весь проект. Запускайте `validate` в CI перед [`gt translate`](/docs/cli/reference/commands/translate), чтобы заранее выявить синтаксические ошибки: при их наличии команда возвращает ненулевой код выхода, и сборка завершается с ошибкой.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.