{"canonical_url":"https://engineer.company/uk/glossary/code-quality/","content_markdown":"# Якість коду\n\n## Що це таке\n\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\nЯкість також допомагає передавати роботу. Учасники змінюють проєкти, тож той, хто читає наступну\nзміну, може не знати історії модуля. Влучні назви, приклад, який можна запустити, і коротке\nпояснення незвичної вимоги дають змогу самостійно перевірити рішення. Це важливо і для навчання, і\nдля чергового, який розбирається зі збоєм.\n\n## Як це виглядає на практиці\n\nПрипустімо, що податок округлюють після підсумовування за кожною ставкою. У рахунку два рядки,\nподаток до округлення становить по 0,005 грошової одиниці. Якщо округлити кожний рядок до сотих із\nправилом округлення половини вгору, сума становитиме 0,02. Якщо спочатку додати значення, а потім\nокруглити один раз, результат буде 0,01. Це можна перевірити вручну. Правило для справжнього\nрахунку має спиратися на вимоги продукту й чинні норми.\n\nУ контракті функції варто назвати одиниці вхідних значень і порядок дій. Проміжні результати мають\nзберігати потрібну точність. Групування має бути помітним, а округлення відбуватися на погодженому\nкроці. Тест із наведеними числами відрізняє два способи. Інший тест із різними ставками допомагає\nвиявити, що хтось замінив групування однією загальною сумою. Для окремої політики повернення\nпотрібен окремий приклад.\n\nПід час рецензування простежте суму, показану клієнту, суму в експорті та виклик під час\nповернення коштів. Старі рахунки зберігають суми, записані під час виставлення. Наскрізна\nперевірка показує, чи до обчислення доходять правильні одиниці. Ізольований тест показує, що\nобчислення робить із відомими вхідними даними.\n\nУ нашій [нотатці про продаж останнього квитка рівно один\nраз](/uk/notes/selling-limited-stock-without-overselling/) такий підхід застосовано до залишків.\nНотатка наводить рівність, яка має завжди виконуватися, описує конкурентні тести та пропонує\nстежити за рівністю в експлуатації. Так рецензент бачить умову, яку має зберегти зміна в\nбудь-якому з відповідних шляхів.\n\n## Де виникають проблеми\n\nВимірювану ознаку легко прийняти за доказ. Покриття показує, які рядки або гілки виконав тест.\nТест може пройти, навіть якщо очікуваний результат закріплює хибне правило округлення. Показник\nскладності допомагає вибрати фрагмент для читання. Якщо рознести просте порівняння між кількома\nнезрозумілими функціями, пошук помилки може стати складнішим. Визначте, який дефект має виявляти\nпоказник, і розгляньте приклади по обидва боки порога.\n\nОчищення коду теж потребує пріоритетів. Нечітка назва в рідкісному звіті має одні наслідки,\nнеоднозначна умова, яка керує всіма платежами, інші. Зафіксуйте ризик, відокремте потрібні\nвиправлення від можливих поліпшень і визначте, коли переглянути рішення. Суперечку про\nформатування часто знімає спільне правило й автоматичний форматер.\n\nЛокальна зміна може перенести проблему в інше місце. Спільна функція для знижки доречна, якщо\nкілька викликів справді використовують одне правило. Якщо ж вона вгадує, яка політика діє для\nпродовження, акції чи повернення, код стає менш зрозумілим. З’ясуйте, які дані й умови справді\nзбігаються. Об’єднайте спільну частину, явно покажіть відмінності та перевірте результат.\n\n## Що почитати далі\n\n- [Правило Google щодо схвалення змін\n  коду](https://google.github.io/eng-practices/review/reviewer/standard.html)\n- [На що звертають увагу рецензенти\n  Google](https://google.github.io/eng-practices/review/reviewer/looking-for.html)\n- [Модульне тестування в Software Engineering at\n  Google](https://abseil.io/resources/swe-book/html/ch12.html)\n\n\u003chttps://engineer.company/uk/glossary/code-quality/\u003e\n","date_modified":"2026-11-19T06:00:51Z","description":"Як оцінити якість коду за коректністю, зрозумілістю та придатністю до змін і вибрати виправлення на основі конкретних перевірок.","formats":{"gemtext":"https://engineer.company/uk/glossary/code-quality/index.gmi","gopher":"https://engineer.company/uk/glossary/code-quality/gophermap","html":"https://engineer.company/uk/glossary/code-quality/","json":"https://engineer.company/uk/glossary/code-quality/index.json","markdown":"https://engineer.company/uk/glossary/code-quality/index.md","pdf":"https://engineer.company/uk/glossary/code-quality/index.pdf"},"kind":"page","language":"uk","title":"Що таке якість коду?","url":"https://engineer.company/uk/glossary/code-quality/","version":1}