---
createdAt: 2025-12-30
updatedAt: 2025-12-30
title: Инициализация Intlayer
description: Узнайте, как инициализировать Intlayer в вашем проекте.
keywords:
  - Инициализация
  - CLI
  - Intlayer
  - AI
slugs:
  - doc
  - concept
  - cli
  - init
history:
  - version: 7.5.9
    date: 2025-12-30
    changes: Добавлена команда init
---

# Инициализация Intlayer

```bash
npx intlayer init
```

Команда `init` автоматически настраивает Intlayer в вашем проекте, конфигурируя необходимые файлы и параметры. Это рекомендуемый способ начать работу с Intlayer.

## Псевдонимы:

- `npx intlayer init`

## Аргументы:

- `--project-root [projectRoot]` - Необязательно. Укажите корневую директорию проекта. Если не указано, команда будет искать корень проекта, начиная с текущей рабочей директории.

## Что делает:

Команда `init` выполняет следующие задачи настройки:

1. **Проверяет структуру проекта** - Убедится, что вы находитесь в валидной директории проекта с файлом `package.json`
2. **Обновляет `.gitignore`** - Добавляет `.intlayer` в ваш файл `.gitignore`, чтобы исключить сгенерированные файлы из системы контроля версий
3. **Настраивает TypeScript** - Обновляет все файлы `tsconfig.json`, чтобы включить определения типов Intlayer (`.intlayer/**/*.ts`)
4. **Создаёт файл конфигурации** - Генерирует `intlayer.config.ts` (для проектов на TypeScript) или `intlayer.config.mjs` (для проектов на JavaScript) с настройками по умолчанию
5. **Обновляет конфигурацию Vite** - Если обнаружен файл конфигурации Vite, добавляет импорт плагина `vite-intlayer`

Команда `init` выполняет следующие действия по настройке:

1. **Проверяет структуру проекта** — Убеждается, что вы находитесь в корректной директории проекта с файлом `package.json`
2. **Обновляет `.gitignore`** — Добавляет `.intlayer` в ваш файл `.gitignore`, чтобы исключить сгенерированные файлы из системы контроля версий
3. **Настраивает TypeScript** — Обновляет все файлы `tsconfig.json`, чтобы включить определения типов Intlayer (`.intlayer/**/*.ts`)
4. **Создаёт файл конфигурации** — Генерирует `intlayer.config.ts` (для проектов на TypeScript) или `intlayer.config.mjs` (для проектов на JavaScript) с настройками по умолчанию
5. **Обновляет конфигурацию Vite** — Если обнаружен файл конфигурации Vite, добавляет импорт плагина `vite-intlayer`
6. **Обновляет конфигурацию Next.js** - Если обнаружен файл конфигурации Next.js, добавляет импорт плагина `next-intlayer`

## Примеры:

### Базовая инициализация:

```bash
npx intlayer init
```

Это инициализирует Intlayer в текущей директории, автоматически обнаруживая корень проекта.

### Инициализация с указанием корня проекта:

```bash
npx intlayer init --project-root ./my-project
```

Это инициализирует Intlayer в указанной директории.

## Пример вывода:

```bash
npx intlayer init
Проверка конфигурации Intlayer...
✓ Добавлено .intlayer в .gitignore
✓ Обновлён tsconfig.json для включения типов intlayer
Создан intlayer.config.ts
✓ Внедрён импорт в vite.config.ts
✓ Настройка Intlayer init завершена.
```

## Примечания:

- Команда идемпотентна — вы можете запускать её несколько раз безопасно. Она пропустит шаги, которые уже настроены.
- Если файл конфигурации уже существует, он не будет перезаписан.
- Файлы конфигурации TypeScript без массива `include` (например, конфигурации в стиле solution с ссылками) пропускаются.
- Команда завершится с ошибкой, если в корне проекта не найден `package.json`.
