re:re:actable
Урок 034 минуты чтения

Как давать и получать обратную связь на код-ревью

На этой странице
Кратко

На 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.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам