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

Ты попросил ИИ поправить одну строчку. Он поправил. А заодно поменял кавычки, отступы и переносы во всём файле. Теперь в списке изменений 400 строк — и среди них где-то прячется та самая одна.
Проверить такое невозможно. А проверять код ИИ надо обязательно. Решение скучное, но работает безотказно: форматтер — программа, которая приводит весь код к одному виду сама. Когда внешний вид всегда одинаковый, в изменениях остаются только настоящие правки.
Что такое форматтер
Форматтер расставляет отступы, кавычки, пробелы и переносы строк по единым правилам. Логику он не трогает — только внешний вид. Как утюг: складки убирает, рубашку не перешивает.
Не путай его с линтером. Линтер ищет подозрительные места в логике. Форматтер просто причёсывает. Обычно в проекте живут оба.
Для JavaScript, TypeScript, CSS, HTML и JSON стандарт — Prettier. Для Python — ruff format или Black. Дальше покажу на Prettier, для Python шаги те же.
Пошагово: Prettier за 10 минут
-
Установи Prettier в проект. Открой терминал в папке проекта и выполни:
pnpm add -D --save-exact prettierЕсли у тебя npm —
npm install --save-dev --save-exact prettier. Флаг--save-exactфиксирует точную версию. Это важно: Prettier меняет стиль даже в мелких обновлениях, и без фиксации код начнёт «переформатироваться сам» у разных людей. -
Создай файл настроек. В корне проекта создай
.prettierrc:{ "semi": false, "singleQuote": true }Это значит: без точек с запятой, одинарные кавычки. Можешь вообще оставить файл пустым —
{}. Тогда будут настройки по умолчанию, и это нормально. Главное не какие правила, а что они одни на весь проект. -
Скажи, что не трогать. Создай
.prettierignoreи перечисли там папки со сборкой и чужим кодом:dist build node_modules -
Отформатируй весь проект один раз.
pnpm exec prettier . --writeИзменений будет много — это нормально. Сделай из них отдельный коммит с понятным названием: «format: prettier на весь проект». Не смешивай его с настоящими правками. Тогда в истории будет видно: вот тут поменялся только вид, логика та же.
-
Включи форматирование при сохранении. В VS Code или Cursor поставь расширение Prettier – Code formatter. Потом открой настройки (
settings.json) и добавь:{ "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode" }Теперь каждый раз, когда ты жмёшь сохранить, файл выравнивается сам. Про выбор редактора — в статье VS Code или Cursor.
-
Научи этому ИИ-агента. Агент не жмёт «сохранить» в редакторе, он пишет файлы напрямую. Поэтому ему нужно правило словами. Добавь в AGENTS.md:
После любых правок запускай: pnpm exec prettier --write на изменённые файлы. Не меняй форматирование в строках, которые не относятся к задаче.
Что получится
После этих шагов код выглядит одинаково, кто бы его ни писал — ты, ИИ или другой агент. И происходит главное:
- Изменения стали короткими. Поправил одну строчку — в диффе одна строчка. Проверять такое можно за минуту.
- Споры закончились. Больше не нужно просить ИИ «ставь одинарные кавычки». Форматтер сделает это сам, каждый раз.
- Ревью стало честным. Ты смотришь на смысл, а не на отступы. Как читать изменения от ИИ — в статье как проверять код от ИИ.
Бонус: проверка перед отправкой
Если проект лежит на GitHub, можно добавить проверку, которая не пропустит неотформатированный код:
pnpm exec prettier . --check
Эта команда ничего не меняет, только сообщает, какие файлы не причёсаны. Её ставят в автоматические проверки, чтобы грязный код не попал в главную ветку.
Prettier сломает мой код?
Нет. Он меняет только внешний вид: пробелы, кавычки, переносы. Логика остаётся той же. Если Prettier ругается и не трогает файл — значит, в коде синтаксическая ошибка: он не может разобрать сломанный код и честно об этом говорит.
Какие настройки Prettier выбрать?
Любые — лишь бы одни на весь проект. Если не знаешь, оставь .prettierrc пустым: стандартные настройки Prettier используют миллионы проектов.
Что если в проекте уже есть другой форматтер?
Используй его. Два форматтера с разными правилами будут бесконечно переделывать работу друг друга.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





