{"canonical_url":"https://engineer.company/uk/glossary/code-review/","content_markdown":"# Рев'ю коду\n\n## Що це таке\n\nРев'ю коду — це етап, на якому зміну, перш ніж вона стане частиною кодової\nбази, читає хтось інший, ніж її автор. Настанови Google щодо інженерних практик\nвизначають його як процес, у якому код перевіряє хтось, крім автора чи авторів\nцього коду, а розділ про рев'ю в книжці _Software Engineering at Google_ додає,\nщо це часто відбувається до того, як код потрапить у кодову базу. Українською\nкажуть і код-рев'ю, а конкретна назва здебільшого залежить від інструмента. На\nGitHub це рев'ю pull request, у Google — рев'ю перед комітом (precommit review),\nа в ядрі Linux воно відбувається електронною поштою: рецензент, задоволений\nпатчем, пропонує до нього тег Reviewed-by.\n\nНастанови Google перелічують, на що дивиться рецензент: дизайн,\nфункціональність, складність, тести, іменування, коментарі, стиль і\nдокументацію. За кожним словом стоїть питання. Чи поводиться код так, як,\nімовірно, задумав автор, і чи добра ця поведінка для його користувачів? Чи можна\nзробити його простішим? Чи має він правильні й добре продумані автоматичні\nтести? Чи оновив автор документацію, яка його описує?\n\nМеханіка всюди приблизно однакова. Автор надсилає diff з описом, рецензенти\nкоментують окремі рядки, автор відповідає або завантажує нову версію, і цикл\nповторюється, доки рецензент не схвалить зміну. У Google таке схвалення\nназивають LGTM, це скорочення від англійського _looks good to me_, а книжка\nописує його як біт дозволу: за замовчуванням потрібен лише один LGTM, і разом зі\nсхваленням власника коду та перевіркою readability він дає змогу закомітити\nзміну. GitHub завершує кожне рев'ю одним із трьох рішень. Comment — це загальний\nвідгук без схвалення чи запиту на зміни, Approve означає, що зміни готові до\nзлиття, а Request changes позначає відгук, який автор має врахувати перед\nзлиттям. Рецензувати й коментувати може будь-хто з доступом на читання, а\nадміністратори репозиторію можуть вимагати схвалень, перш ніж pull request\nзіллють. Настанови Google називають кожну зміну CL, тому одна з їхніх сторінок\nмає назву Small CLs.\n\n## Чому це важливо\n\nКнижка називає шість переваг добре налагодженого рев'ю. Воно перевіряє, що код\nправильний, гарантує, що інші інженери зрозуміють зміну, підтримує\nодноманітність кодової бази, розвиває в команді спільне володіння кодом,\nпоширює знання й залишає історичний запис. Правильність — найочевидніша з них,\nі автори посилаються на дослідження в IBM, опубліковане 1986 року, яке\nпоказало, що вади, знайдені раніше, виправляти швидше. Книжка додає важливу\nумову: час, вкладений у рев'ю, окуповувався лише доти, доки процес лишався\nлегким. Статичний аналіз і автоматичні тести сьогодні беруть на себе значну\nчастину роботи з правильності, і, за словами книжки, це зменшило потребу\nпокладатися тут на людей.\n\nА от розуміння інструмент не забезпечить. Рецензент може зробити те, чого навіть\nнайкращий інженер не зробить для власної роботи: прочитати її без авторового\nпогляду, і рев'ю часто стає першою перевіркою того, чи зрозуміла зміна ще\nкомусь. Це важливо, бо код читають набагато більше разів, ніж пишуть. Культурні\nпереваги менш помітні. Рев'ю нагадує інженерові, що код належить не йому\nособисто, а спільній справі, дає експертам змогу передавати знання про свою\nділянку, а оскільки кожна зміна зберігає своє рев'ю, будь-хто згодом може\nз'ясувати, коли з'явився певний патерн, і прочитати рев'ю, яке його принесло.\n\nРев'ю також забирає час, а повільне рев'ю — ще більше. Сторінка настанов Google\nпро швидкість каже, що коли рев'ю повільні, падає швидкість усієї команди,\nрозробники починають опиратися процесу, а стан коду погіршується, бо з'являється\nтиск пропускати слабші зміни, а охоти прибирати в коді меншає. Більшість скарг\nна надто суворого рецензента, додають настанови, зникає, коли той самий\nрецензент просто відповідає швидше. Їхній стандарт схвалення прагматичний:\nрецензентам варто схвалювати зміну, щойно вона безперечно покращує загальний\nстан коду системи, навіть якщо вона не досконала. Настанови називають це\nголовним принципом серед своїх правил і вміщують обґрунтування в один рядок:\n«ідеального коду не існує — існує лише кращий код».\n\n## Як це виглядає на практиці\n\nУявіть інтернет-магазин, де ціни записані в цілих пенсах. Автор додає весняну\nакцію й надсилає на рев'ю таку зміну:\n\n```diff\n--- a/shop/pricing.py\n+++ b/shop/pricing.py\n@@ -8,2 +8,4 @@ def order_total(basket):\n     subtotal = sum(line.price * line.quantity for line in basket.lines)\n+    if basket.voucher == \"SPRING\":\n+        subtotal = subtotal * 0.9\n     return subtotal + shipping_for(basket)\n```\n\nРецензент залишає чотири коментарі:\n\n```text\nshop/pricing.py, рядок 9\n  Інші промокоди та їхні знижки лежать у VOUCHERS у\n  shop/vouchers.py. Може, SPRING теж туди? Тоді наступна\n  акція буде зміною даних, а не цієї функції.\n\nshop/pricing.py, рядок 10\n  Скрізь у цьому модулі ціни в цілих пенсах, а множення\n  на 0.9 може залишити частку пенса. Інші знижки проходять\n  через round_money() у shop/money.py.\n\nshop/pricing.py, рядок 11\n  Nit: доставка не входить у знижку. Якщо це навмисно,\n  короткий коментар про це допоможе наступному читачеві.\n\nЗагалом\n  Бракує тесту з промокодом у кошику. Додай, будь ласка,\n  один для SPRING і один, який показує, що невідомий код\n  ціну не змінює.\n```\n\nКожен коментар стосується коду, а не людини, і кожен пояснює причину. Перший,\nдругий і останній не мають позначки, тож їх очікують виконати; третій\nпочинається з Nit:, яким настанови Google позначають щось дрібне, що автор\nтехнічно мав би зробити, але що мало на що вплине. Інші позначки в настановах —\nOptional, або Consider, для доброї ідеї, яка не є обов'язковою, і FYI для\nдумки, на яку автор не мусить реагувати в цій зміні. Без позначок, попереджають\nнастанови, автори можуть сприймати кожен коментар як обов'язковий. На GitHub\nцей раунд завершується рішенням Request changes. Автор переносить SPRING у\nтаблицю, пропускає знижку через функцію округлення, додає коментар і обидва\nтести та просить подивитися ще раз; другий раунд завершується рішенням Approve,\nа в Google — LGTM. Настанови просять рецензентів відповідати на запит про рев'ю\nщонайбільше протягом одного робочого дня, але не переривати заради цього\nзосереджену роботу, а дочекатися природної перерви.\n\nКоментарі не стосуються ні форматування, ні порядку імпортів, ні того, чи\nпроходять тести, бо про це мала сказати машина ще до того, як рецензент відкрив\ndiff. Книжка описує presubmit-перевірки, які запускаються, щойно зміну вперше\nнадіслано на рев'ю, і можуть відхилити її ще до того, як хтось її прочитає;\nядро Linux просить авторів перед надсиланням запустити його перевірку стилю,\n`scripts/checkpatch.pl`.\n[Механізм перевірок, побудований для репозиторію](/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/),\nробота 2025 року, доводить цю ідею далеко: 268 зареєстрованих перевірок коміту,\n277 правил лінтингу і 15 власних правил ESLint, а також 146 тестів самих\nперевірок. Перевірки стежать, зокрема, за тим, що міграцію можна відкотити і що\nключ перекладу існує в обох локалях, а будь-який коміт із префіксом fix: мусить\nмістити тест, який без цього виправлення падає. Перевірки закодували механічні правила,\nтож рецензенти могли приділяти більше часу проєктуванню. Вона ж називає й ціну:\nкомітити повільно, а погано написана перевірка, яку доводиться обходити,\nсправді доводить до сказу.\n\n## Де виникають проблеми\n\n**Зміна завелика, щоб її прочитати.** Настанови Google вважають 100 рядків\nзазвичай розумним розміром зміни, а 1 000 рядків — зазвичай завеликим, хоча\nостаточне рішення лишають рецензентові, і зауважують, що 200 рядків в одному\nфайлі можуть бути цілком прийнятними, тоді як ті самі 200 рядків, розкидані по\n50 файлах, — ні. Невеликі зміни переглядають швидше й ретельніше, і вони рідше\nвносять помилки; книжка додає, що рецензенти мають повне право відхилити зміну\nяк завелику для одного рев'ю. Розбивайте роботу: складайте невеликі зміни одна\nна одну, розсилайте групи файлів різним рецензентам, тримайте рефакторинг\nокремо від нових функцій і виправлень помилок, а тести кожної зміни — в тій\nсамій зміні.\n\n**Рев'ю лежить днями.** Кожен день, поки зміна чекає, відсуває роботу, що на\nній будується, а рецензент, який відповідає раз на кілька днів, та ще й\nвеликими вимогами, робить процес суворішим на вигляд, ніж він є. Відповідайте\nпротягом одного робочого дня; книжка очікує відгуку протягом 24 робочих годин, а\nякщо повне рев'ю мусить зачекати, рецензентові варто сказати, що зміну він\nбачив. Надсилайте всі коментарі разом, а не частинами, бо мало що дратує автора\nбільше, ніж новий раунд не пов'язаних зауважень після того, як попередні вже\nвраховано.\n\n**Смак видають за вимогу.** Рецензент, який віддає перевагу іншому циклу чи\nіншій назві й блокує через це зміну, привчає авторів більше не покращувати код.\nНастанови Google встановлюють порядок: технічні факти й дані важать більше, ніж\nдумки та особисті вподобання, у питаннях стилю абсолютним авторитетом є\nпосібник зі стилю, а там, де кілька підходів однаково слушні, перевагу має вибір\nавтора. Позначайте вподобання як Nit або Optional, щоб автор міг відрізнити його\nвід вимоги.\n\n**Коментар стосується людини.** У прикладі поганого коментаря з настанов\nрецензент питає, навіщо автор використав потоки, коли від конкурентності\nочевидно немає користі; добрий варіант каже, що модель конкурентності додає\nскладності без виграшу в продуктивності, який бачив би рецензент, тож код краще\nзробити однопотоковим. Коментуйте код, а не розробника, і пояснюйте, чим\nобґрунтоване прохання.\n\n**Люди перевіряють те, що могла б машина.** Рецензенти, які витрачають увагу на\nвідступи й порядок імпортів, пропускають питання проєктування, на яке може\nвідповісти лише людина. Перенесіть кожне правило, яке можна записати, у лінтер,\nформатер або presubmit-перевірку, а рецензентові залиште судження.\n\n**Відповідь лишається в інструменті рев'ю.** Рецензент питає, для чого потрібен\nблок коду, автор пояснює це в обговоренні, рецензент схвалює, і наступна\nлюдина, яка читатиме код, пояснення так і не побачить. Настанови Google кажуть,\nщо таке питання зазвичай має привести до того, що код перепишуть зрозуміліше,\nабо принаймні до коментаря в коді. Ядро Linux каже авторам те саме: запитання\nна рев'ю, які не ведуть до зміни коду, майже напевно мають обернутися\nкоментарем у коді або записом у журналі змін.\n\n## Що почитати далі\n\n- [Introduction](https://google.github.io/eng-practices/review/)\n  — вступна сторінка настанов Google щодо рев'ю коду: на що дивляться\n  рецензенти, як їх обирати і коли парне програмування зараховують як рев'ю.\n- [The Standard of Code Review](https://google.github.io/eng-practices/review/reviewer/standard.html)\n  — головний принцип, наставництво через рев'ю і розв'язання суперечок між\n  автором і рецензентом.\n- [Small CLs](https://google.github.io/eng-practices/review/developer/small-cls.html)\n  — чому невеликі зміни отримують кращі рев'ю, коли зміна завелика, і чотири\n  способи її розбити.\n- [Code Review](https://abseil.io/resources/swe-book/html/ch09.html)\n  — розділ Tom Manshreck і Caitlin Sadowski у _Software Engineering at Google_:\n  переваги рев'ю, LGTM і власники коду, найкращі практики.\n- [Pull request reviews](https://docs.github.com/en/pull-requests/reference/pull-request-reviews)\n  — довідка GitHub про рев'ю, схвалення й запит на зміни та про обов'язкові\n  схвалення перед злиттям.\n- [Submitting patches: the essential guide to getting your code into the kernel](https://docs.kernel.org/process/submitting-patches.html)\n  — як ядро Linux рецензує зміни через електронну пошту, що засвідчує тег\n  Reviewed-by і як авторам відповідати рецензентам.\n\n\u003chttps://engineer.company/uk/glossary/code-review/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що перевіряє рев'ю коду, розібраний приклад невеликої зміни цін із позначеними коментарями і звички, через які рев'ю стає повільним або особистим.","formats":{"gemtext":"https://engineer.company/uk/glossary/code-review/index.gmi","gopher":"https://engineer.company/uk/glossary/code-review/gophermap","html":"https://engineer.company/uk/glossary/code-review/","json":"https://engineer.company/uk/glossary/code-review/index.json","markdown":"https://engineer.company/uk/glossary/code-review/index.md","pdf":"https://engineer.company/uk/glossary/code-review/index.pdf"},"kind":"page","language":"uk","title":"Що таке рев'ю коду?","url":"https://engineer.company/uk/glossary/code-review/","version":1}