Как давать и получать обратную связь на код-ревью
На этой странице
На 3,5 годах опыта код-ревью — обязательная часть работы, и о нем спрашивают почти всегда: на что вы смотрите, как формулируете замечания, как реагируете на критику своего кода, что делаете при несогласии. Хорошее ревью ищет ошибки логики, проблемы с поддержкой, безопасностью и производительностью, а не спорит о стиле (его проверяют линтеры). Комментарии — конкретные, вежливые, с объяснением «почему» и разделением на обязательные и необязательные. Критику своего кода воспринимают как заботу о продукте, а не как личную оценку.
Вопрос
Как вы проводите код-ревью, на что обращаете внимание и как формулируете замечания? Как реагируете на критику своего кода и что делаете, если не согласны с ревьюером?
На что смотреть при ревью
| Уровень | Что проверять |
|---|---|
| Задача | решает ли PR то, что нужно; все ли сценарии и состояния (загрузка, ошибка, пусто) |
| Корректность | логика, граничные случаи, гонки запросов, утечки (подписки, таймеры) |
| Архитектура | правильный слой и модуль, нет дублирования, понятные границы |
| Читаемость | имена, размер функций и компонентов, понятность без автора |
| Типы | нет any без причины, корректные типы API |
| Производительность | лишние ререндеры, тяжелые зависимости, размер бандла |
| Безопасность | dangerouslySetInnerHTML, секреты в коде, проверка прав |
| Доступность | семантика, клавиатура, alt, label |
| Тесты | покрыты ли важные сценарии, не хрупкие ли тесты |
Стиль и форматирование — задача ESLint и Prettier, а не человека.
Как формулировать замечания
| Плохо | Хорошо |
|---|---|
| «Это неправильно» | «Здесь при быстрой смене фильтра старый ответ может перезаписать новый. Может, добавить AbortController?» |
| «Переделай» | «Предлагаю вынести эту логику в хук useCartTotals — она понадобится и в чекауте» |
| «Почему так?» (с раздражением) | «Не до конца понял, зачем здесь useEffect, — можно вычислить значение при рендере?» |
Приемы:
- вопросы вместо приказов, если не уверены;
- объяснение «почему» и ссылка на документацию;
- разделение по важности: обязательное /
nit:(мелочь) /suggestion:/question:; - хвалить хорошие решения — ревью не только поиск ошибок;
- большие вопросы — голосом, а не 30 комментариями;
- быстрый ответ: ревью в течение рабочего дня, чтобы не блокировать коллег.
Как получать критику
- Благодарить за ревью и не воспринимать замечания лично.
- Если комментарий непонятен — переспросить, а не угадывать.
- Если согласны — исправить; если нет — объяснить аргументы, а не молча проигнорировать.
- Повторяющиеся замечания — повод добавить правило в линтер или чек-лист.
- Делать PR небольшими, с понятным описанием и скриншотами — так ревью проще и быстрее.
Если не согласны с ревьюером
1. Объяснить свою логику с фактами (документация, замер, пример)
2. Спросить, какую проблему видит ревьюер
3. Если спор затягивается — созвониться
4. Не блокировать задачу: договориться о решении или привлечь третьего (лид, автор модуля)
5. Принципиальные вопросы — зафиксировать как договоренность командыПример ответа на собеседовании
«В нашей команде любой PR смотрит минимум один человек. При ревью я сначала проверяю, что задача решена целиком, включая состояния загрузки и ошибок, затем логику и граничные случаи, архитектуру и типы. Стиль не комментирую — это делает линтер. Замечания помечаю: обязательные и
nitдля мелочей, и всегда объясняю причину. Если вижу, что у человека много похожих замечаний, предлагаю созвониться и разобрать вместе — так быстрее и меньше напряжения. Однажды мы с командой заметили, что спорим об одном и том же, и составили чек-лист ревью — после этого ревью стали короче».
Что важно помнить
- Цель ревью — качество продукта и обмен знаниями, а не демонстрация превосходства.
- Маленькие PR ревьюятся лучше и быстрее.
- Автоматизируйте то, что можно автоматизировать: форматирование, линтинг, типы, тесты.
- Связанные темы: ESLint, Git-хуки.
Мини-шпаргалка
Смотреть: задача целиком → логика и граничные случаи → архитектура → читаемость → типы → производительность → безопасность → a11y → тесты; стиль — линтеру. Формулировать: конкретно, «почему», вопросы, nit/обязательное, хвалить. Получать: благодарить, переспрашивать, аргументировать, не принимать лично. Спор — голосом и через договоренности команды.
Документация
Google Engineering Practices: Code Review, Conventional Comments, Google: The Standard of Code Review.