Гайды

Как автоматически форматировать код — и почему это нужно, когда пишет ИИ

Иллюстрация: кривая куча кубиков заходит в гребёнку и выходит ровными рядами

Ты попросил ИИ поправить одну строчку. Он поправил. А заодно поменял кавычки, отступы и переносы во всём файле. Теперь в списке изменений 400 строк — и среди них где-то прячется та самая одна.

Проверить такое невозможно. А проверять код ИИ надо обязательно. Решение скучное, но работает безотказно: форматтер — программа, которая приводит весь код к одному виду сама. Когда внешний вид всегда одинаковый, в изменениях остаются только настоящие правки.

Что такое форматтер

Форматтер расставляет отступы, кавычки, пробелы и переносы строк по единым правилам. Логику он не трогает — только внешний вид. Как утюг: складки убирает, рубашку не перешивает.

Не путай его с линтером. Линтер ищет подозрительные места в логике. Форматтер просто причёсывает. Обычно в проекте живут оба.

Для JavaScript, TypeScript, CSS, HTML и JSON стандарт — Prettier. Для Python — ruff format или Black. Дальше покажу на Prettier, для Python шаги те же.

Пошагово: Prettier за 10 минут

  1. Установи Prettier в проект. Открой терминал в папке проекта и выполни:

    pnpm add -D --save-exact prettier
    

    Если у тебя npm — npm install --save-dev --save-exact prettier. Флаг --save-exact фиксирует точную версию. Это важно: Prettier меняет стиль даже в мелких обновлениях, и без фиксации код начнёт «переформатироваться сам» у разных людей.

  2. Создай файл настроек. В корне проекта создай .prettierrc:

    {
      "semi": false,
      "singleQuote": true
    }
    

    Это значит: без точек с запятой, одинарные кавычки. Можешь вообще оставить файл пустым — {}. Тогда будут настройки по умолчанию, и это нормально. Главное не какие правила, а что они одни на весь проект.

  3. Скажи, что не трогать. Создай .prettierignore и перечисли там папки со сборкой и чужим кодом:

    dist
    build
    node_modules
    
  4. Отформатируй весь проект один раз.

    pnpm exec prettier . --write
    

    Изменений будет много — это нормально. Сделай из них отдельный коммит с понятным названием: «format: prettier на весь проект». Не смешивай его с настоящими правками. Тогда в истории будет видно: вот тут поменялся только вид, логика та же.

  5. Включи форматирование при сохранении. В VS Code или Cursor поставь расширение Prettier – Code formatter. Потом открой настройки (settings.json) и добавь:

    {
      "editor.formatOnSave": true,
      "editor.defaultFormatter": "esbenp.prettier-vscode"
    }
    

    Теперь каждый раз, когда ты жмёшь сохранить, файл выравнивается сам. Про выбор редактора — в статье VS Code или Cursor.

  6. Научи этому ИИ-агента. Агент не жмёт «сохранить» в редакторе, он пишет файлы напрямую. Поэтому ему нужно правило словами. Добавь в AGENTS.md:

    После любых правок запускай: pnpm exec prettier --write на изменённые файлы.
    Не меняй форматирование в строках, которые не относятся к задаче.
    

Что получится

После этих шагов код выглядит одинаково, кто бы его ни писал — ты, ИИ или другой агент. И происходит главное:

  • Изменения стали короткими. Поправил одну строчку — в диффе одна строчка. Проверять такое можно за минуту.
  • Споры закончились. Больше не нужно просить ИИ «ставь одинарные кавычки». Форматтер сделает это сам, каждый раз.
  • Ревью стало честным. Ты смотришь на смысл, а не на отступы. Как читать изменения от ИИ — в статье как проверять код от ИИ.

Бонус: проверка перед отправкой

Если проект лежит на GitHub, можно добавить проверку, которая не пропустит неотформатированный код:

pnpm exec prettier . --check

Эта команда ничего не меняет, только сообщает, какие файлы не причёсаны. Её ставят в автоматические проверки, чтобы грязный код не попал в главную ветку.

Prettier сломает мой код?

Нет. Он меняет только внешний вид: пробелы, кавычки, переносы. Логика остаётся той же. Если Prettier ругается и не трогает файл — значит, в коде синтаксическая ошибка: он не может разобрать сломанный код и честно об этом говорит.

Какие настройки Prettier выбрать?

Любые — лишь бы одни на весь проект. Если не знаешь, оставь .prettierrc пустым: стандартные настройки Prettier используют миллионы проектов.

Что если в проекте уже есть другой форматтер?

Используй его. Два форматтера с разными правилами будут бесконечно переделывать работу друг друга.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →