{"canonical_url":"https://engineer.company/uk/glossary/refactoring/","content_markdown":"# Рефакторинг\n\n## Що це таке\n\nРефакторинг — це зміна внутрішньої структури коду без зміни того, що код робить\nдля будь-кого, хто ним користується. Змінюються назви, межі функцій і поділ на\nмодулі; вхідні дані, вихідні дані й побічні ефекти лишаються точно такими, як\nбули. Окрему таку зміну теж називають рефакторингом. Англійською це називають\nrefactoring.\n\nМартін Фаулер дає визначення цього терміна у своїй книжці Refactoring і повторив\nйого на своєму сайті 2004 року. Як іменник рефакторинг — це зміна внутрішньої\nструктури програмного забезпечення, яка робить його легшим для розуміння й\nдешевшим для змін, не змінюючи його спостережуваної поведінки. Як дієслово (to\nrefactor) воно означає перебудовувати програмне забезпечення, застосовуючи низку\nтаких змін, знову ж таки не змінюючи його спостережуваної поведінки. Важливі\nобидві половини. Мета — дешевша наступна зміна, а обмеження в тому, що ніхто\nпоза кодом не може помітити, що щось сталося.\n\nФаулер чітко проводить межу: «Рефакторинг — не просто інша назва прибирання\nкоду», пише він на refactoring.com. Це назва однієї конкретної техніки. Ширшим\nсловом для реорганізації коду будь-якими засобами, зокрема такими, що не\nзберігають поведінку на кожному кроці, він вважає реструктуризацію\n(restructuring). Техніку з рефакторингу робить розмір кроків. Кожен крок —\nневелике перетворення, яке саме по собі робить мало й навряд чи піде не так, а\nсистема залишається повністю робочою після кожного з них. Довга послідовність\nтаких кроків усе одно може скластися у велику зміну структури.\n\nКроки мають назви. Каталог на refactoring.com, що супроводжує друге видання\nкнижки, перелічує їх разом зі старішими назвами, які вони замінили: прийом\nExtract Function, раніше Extract Method, і обернений до нього Inline Function;\nInline Variable; Rename Variable; Move Function; Split Phase і ще десятки.\nСпільна назва дає розробникові змогу двома словами сказати, якою була зміна, а\nтому, хто переглядає код, — звірити її з відомим рецептом.\n\n## Чому це важливо\n\nУспішне програмне забезпечення постійно змінюється. Нова функціональність і\nвиправлення нашаровуються одне на одне, і кожна зміна зазвичай робить наступну\nтрохи складнішою, доки нова робота, як описує Фаулер, не починає ледве повзти.\nРефакторинг — це противага: він переформовує код так, щоб кожне доповнення не\nприносило складності, якої йому не треба. Віддачу вимірюють ціною наступної\nзміни, а не тим, як виглядає код.\n\nТому Фаулер вважає його частиною звичайного програмування, а не завданням, яке\nз'являється в плані проєкту. Він називає три моменти. Перш ніж додати нову\nфункціональність, він перевіряє, чи має код таку форму, щоб її було легко\nдодати, і якщо ні, спершу робить рефакторинг, що, як він зазвичай переконується,\nшвидше, ніж втискати функціональність силоміць. Коли функціональність працює,\nвін рефакторингом доводить результат до форми, яку без зайвих роздумів зрозуміє\nтой, хто повернеться до коду за кілька тижнів. А коли йому доводиться читати\nнезнайомий код, щоб його зрозуміти, він робить рефакторинг, щоб наступний читач\nне спотикався на тому самому місці. Перший із цих моментів має власну назву,\nпідготовчий рефакторинг (preparatory refactoring), і Фаулер приписує Кенту Беку\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```javascript\nfunction printReceipt(order) {\n  let total = 0;\n  for (const line of order.lines) {\n    total += line.price * line.quantity;\n  }\n\n  // вивести рядки чека\n  console.log(`Order ${order.id}`);\n  console.log(`Total: ${total}`);\n}\n```\n\nНадходить нова вимога: та сама сума має з'явитися в рахунку. Замість того щоб\nкопіювати цикл, розробник спершу робить рефакторинг. Перший крок — Extract\nFunction: цикл переходить в окрему функцію, названу за тим, що вона обчислює, і\nзапускаються тести. Другий крок так само виокремлює друк, тож назва функції\nзамінює коментар, і тести запускаються знову. Третій крок — Inline Variable:\nзмінна `total` тепер використовується лише раз, тож її місце займає виклик.\nПісля кожного кроку програма робить точно те саме, що й раніше, і кожен крок міг\nби стати окремим комітом:\n\n```javascript\nfunction printReceipt(order) {\n  printLines(order.id, orderTotal(order));\n}\n\nfunction orderTotal(order) {\n  let total = 0;\n  for (const line of order.lines) {\n    total += line.price * line.quantity;\n  }\n  return total;\n}\n\nfunction printLines(id, total) {\n  console.log(`Order ${id}`);\n  console.log(`Total: ${total}`);\n}\n```\n\nЛише тепер суму додають до рахунку, і для цього потрібен один рядок у коді\nрахунків, який викликає `orderTotal`. Жоден із трьох кроків рефакторингу не\nпотребував нового тесту, бо нічого спостережуваного не змінилося; доводять це\nсаме ті тести, що вже покривали чек.\n\nРефакторинг роблять і в інфраструктурному коді, і там ставки вищі, бо назви\nвказують на ресурси, які працюють. Документація Terraform попереджає, що зміна\nадреси ресурсу в конфігурації за замовчуванням є вказівкою знищити наявний\nресурс і створити новий. Тож перейменування `aws_instance.a` на\n`aws_instance.web` заради читабельності замінило б сервер. Починаючи з Terraform\nv1.1, блок `moved` натомість фіксує стару адресу, і наступний план оновлює\nадресу, нічого не знищуючи:\n\n```hcl\nresource \"aws_instance\" \"web\" {\n  # (конфігурація без змін)\n}\n\nmoved {\n  from = aws_instance.a\n  to   = aws_instance.web\n}\n```\n\nДля старіших версій документація радить для такого самого переміщення команду\n`terraform state mv`. Так чи інакше, рефакторинг безпечний лише тоді, коли план\nпрочитано і він показує переміщення, а не знищення й створення.\n\nТакі зміни легше тримати окремо від роботи над новою функціональністю, коли\nісторія показує, що є що. Стандарт комітів, описаний у записі в портфоліо на\nцьому сайті про те, як\n[привести чотири репозиторії до одного стандарту історії](/uk/portfolio/held-4-repositories-to-one-history-standard/),\nвимагає починати кожне повідомлення коміту з конвенційного префікса, що вказує\nтип зміни, а хук для повідомлень комітів забезпечує дотримання цього правила.\nЗапис, що описує роботу, виконану в липні 2026 року, налічує в історії\nнайбільшого репозиторію 26 комітів рефакторингу поряд із 156 комітами з новими\nфункціями та 133 виправленнями. Він також чесно визнає, що хук перевіряє формат,\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бажання запустити код і перевірити результат на око, напишіть натомість тест.\n\n**Перейменування в інфраструктурному коді замінює ресурс.** Охайна нова назва в\nTerraform під час перегляду коду виглядає як рефакторинг, а план тихо пропонує\nзнищити базу даних і створити порожню. Фіксуйте кожне перейменування і кожне\nпереміщення в модуль чи з модуля блоком `moved`, а будь-яке знищення в плані\nзміни, задуманої як рефакторинг, вважайте невдалим кроком.\n\n**Старий блок `moved` видаляють.** Блоки moved накопичуються, і їх видалення\nвиглядає як звичайне прибирання. Документація Terraform називає це зміною, що\nпорушує сумісність: будь-яка конфігурація, яка досі має стару адресу, тоді\nспланує видалення наявного об'єкта замість його переміщення. Зберігайте\nісторичні блоки, вибудовуйте їх у ланцюжок, коли об'єкт перейменовують двічі, і\nвидаляйте їх лише з приватного модуля, коли всі, хто ним користується, виконали\napply з версією, що їх містить.\n\n**Рефакторинг чекає на окремий етап.** Команда, що відкладає рефакторинг на\nокремий період десь згодом, і далі додає функціональність до коду, який їй\nопирається, а період, запланований на потім, легко викреслити, коли зсуваються\nтерміни. Фаулер радить протилежне: робіть рефакторинг як частину кожної зміни,\nспершу щоб зробити зміну легкою, а потім щоб залишити результат зрозумілим, тож\nця робота ніколи не потребує окремого місця в плані.\n\n## Що почитати далі\n\n- [Definition Of Refactoring](https://martinfowler.com/bliki/DefinitionOfRefactoring.html)\n  — визначення Мартіна Фаулера для іменника й дієслова, як він подає їх у своїй\n  книжці.\n- [Refactoring](https://refactoring.com/) — сайт Фаулера до книжки: чому\n  рефакторинг є частиною щоденного програмування, і повний каталог.\n- [Extract Function](https://refactoring.com/catalog/extractFunction.html)\n  — запис каталогу про один із найпоширеніших рефакторингів, з оберненим до\n  нього прийомом і назвою з першого видання.\n- [An example of preparatory refactoring](https://martinfowler.com/articles/preparatory-refactoring-example.html)\n  — Фаулер малими кроками перебудовує власний код, перш ніж додати нову\n  функціональність, і пояснює два капелюхи.\n- [Refactor modules](https://developer.hashicorp.com/terraform/language/modules/develop/refactoring)\n  — документація Terraform про блоки `moved`, перейменування, поділ модулів і\n  про те, чому старі блоки варто залишати.\n\n\u003chttps://engineer.company/uk/glossary/refactoring/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що вважають рефакторингом, як малі кроки зберігають код робочим, як безпечно перейменовувати інфраструктуру і де рефакторинг іде не так.","formats":{"gemtext":"https://engineer.company/uk/glossary/refactoring/index.gmi","gopher":"https://engineer.company/uk/glossary/refactoring/gophermap","html":"https://engineer.company/uk/glossary/refactoring/","json":"https://engineer.company/uk/glossary/refactoring/index.json","markdown":"https://engineer.company/uk/glossary/refactoring/index.md","pdf":"https://engineer.company/uk/glossary/refactoring/index.pdf"},"kind":"page","language":"uk","title":"Що таке рефакторинг?","url":"https://engineer.company/uk/glossary/refactoring/","version":1}