{"canonical_url":"https://engineer.company/uk/glossary/ruff/","content_markdown":"# Ruff\n\n## Що це таке\n\nRuff — це одна програма для командного рядка, написана на Rust, яка звіряє\nвихідний код Python із каталогом правил лінтингу й форматує його в\nєдиному послідовному стилі. За ним стоїть Astral, компанія, що створила uv і ty, а\nщоденну роботу виконують дві підкоманди: `ruff check` — це лінтер, а\n`ruff format` — форматувач. Ruff заявляє, що працює в 10–100 разів швидше за\nFlake8 і Black, зберігає кеш, щоб не аналізувати незмінені файли вдруге, і може\nзамінити Flake8 із десятками його плагінів, Black, isort, pydocstyle, pyupgrade\nі autoflake.\n\nЛінтер має понад 900 правил, і чимало з них — власні переписані версії\nпопулярних плагінів Flake8. Кожне правило має код із короткого префікса й трьох\nцифр, а префікс каже, звідки правило походить: F401, невживаний імпорт, узято з\nPyflakes, а E501, задовгий рядок, — із pycodestyle. Конфігурація обирає правила\nза цими кодами, поодинці або за префіксом, тож `select = [\"E\", \"F\"]` вмикає\nкожне правило, чий код починається з E чи F, а особливий селектор `ALL` вмикає\nвсе. Багато правил мають виправлення, і їх поділено на безпечні, які мають\nзберегти поведінку під час виконання, і небезпечні, які можуть її змінити;\n`ruff check --fix` застосовує лише безпечні, якщо не додати ще й\n`--unsafe-fixes`.\n\nФорматувач задумано як пряму заміну Black. На таких кодових базах, як Django і\nZulip, понад 99,9% рядків виходять ідентичними, хоча документація прямо каже, що\nці два інструменти не призначені для того, щоб перемикатися між ними туди й\nназад на тому самому коді. Як і Black, він пропускає ділянки між `# fmt: off` і\n`# fmt: on`.\n\nОбидві половини читають ту саму конфігурацію, яка лежить у таблиці `[tool.ruff]`\nфайлу `pyproject.toml` або у файлі `ruff.toml` чи `.ruff.toml`. Кожен файл\nPython перевіряють за найближчим файлом конфігурації над ним, і цей файл\nзастосовують цілком: Ruff нічого не підмішує з батьківських тек, якщо найближчий\nфайл не вкаже на батьківський через `extend`. Параметри з командного рядка мають\nперевагу над будь-яким файлом. Якщо нічого не задано, рядок може мати 88\nсимволів, як у Black, а версію Python, з якої виходять правила, беруть із поля\n`requires-python` проєкту, коли жодна конфігурація її не називає.\n\n## Чому це важливо\n\nШвидкість вирішує, де перевірці дозволять працювати. Лінтер, повільний\nнастільки, що перериває людину, витісняють у безперервну інтеграцію, де він\nзвітує вже тоді, коли автор узявся за інше. Той, що відповідає швидко, може\nпрацювати в редакторі й у commit-хуку, поки зміна ще свіжа.\n\nОб'єднання знімає суперечки між інструментами. Проєкт, який лінтить через Flake8\nіз плагінами, сортує імпорти через isort і форматує через Black, мусить тримати\nузгодженими кілька конфігурацій і кілька зафіксованих версій. Ruff дає одну\nконфігурацію, одну версію, яку треба зафіксувати, і одну нумерацію правил, а ще\nпублікує перелік правил лінтера, що конфліктують із його власним форматувачем,\nщоб ці два інструменти можна було узгодити свідомо.\n\nКоди виходу роблять Ruff перевіркою без обгортки. `ruff check` завершується з\nкодом 0, коли порушень не лишилося або всі виправлено, з кодом 1, коли порушення\nлишаються, і з кодом 2, коли конфігурація чи командний рядок недійсні або сам\nRuff дав збій, так само як ESLint і Prettier. `ruff format --check` завершується\nз кодом 1, коли хоч один файл було б переформатовано. Правило або обране, або\nвимкнене, і будь-яке обране правило, що спрацювало, ставить код виходу 1.\n\nЦіна в тому, що набір правил — це рішення, яке хтось має взяти на себе. Власна\nпорада Ruff — перелічувати правила явно через `select`, а не нашаровувати\n`extend-select`, починати з E і F, додавати по одній групі за раз, а `ALL`\nвмикати обачно, бо він приносить нові правила з кожним оновленням.\n\n## Як це виглядає на практиці\n\nRuff відповідав за Python у\n[планці нуля попереджень для шести мов](/uk/portfolio/set-a-zero-warnings-bar-across-six-languages/),\nде кожна мова мала власний лінтер. Кожна діагностика вважалася помилкою, а\ninline-придушення були заборонені, і для Ruff це виключає коментар `# noqa`:\nзнахідку в Python можна було виправити в коді й більше ніяк. Хуки pre-commit і\npre-push запускали лінтери й тести, тож перевірка відбувалася ще до того, як\nз'являвся коміт.\n\nНа зафіксованому етапі в жовтні 2026 року Ruff на цьому сайті мав менший обсяг\nроботи: 22 допоміжні скрипти поряд зі збіркою Hugo. Сторінка\n[Подяки](/uk/credits/) називає Ruff серед інструментів, що підтримують вихідний\nкод у порядку. Набір правил у `pyproject.toml` виміряно, а не обрано. Кожну з 54\nродин правил Ruff прогнали на цих скриптах 15 жовтня 2026 року, 39 із них нічого\nне повідомили, і ті мовчазні родини, чия тема — саме такий код, додали до\nпочаткових одинадцяти, тож тепер обрано 33. Родина безпеки, S, лишається\nввімкненою, а п'ять її правил ігноровано за кодом, кожне з коментарем про те,\nчому позначений тут шаблон є безпечним двійником небезпечного, тож решта правил\nцієї родини й далі може зупинити коміт. Три специфічні для Ruff правила про\nнеоднозначні символи Unicode ігноровано, бо текст сайту свідомо вживає справжні\nдовгі й короткі тире та данські літери.\n\nКонфігурація pre-commit запускає `ruff check` і `ruff format --check` на кожному\nфайлі Python у `scripts/`, якого торкається коміт, а задача `fix` у Taskfile\nпроєкту запускає ті самі дві команди в режимі, що виправляє. Поряд із Ruff\nстоїть basedpyright, перевіряч типів, із коментарем, що проводить межу між ними:\nлінтер не стежить за значенням через межу функції, і під час першого запуску\nперевіряч типів знайшов два справжні дефекти, які Ruff пропустив як чисті.\n\n## Де виникають проблеми\n\nЗдебільшого клопіт із Ruff походить від конфігурації, яка буквальніша за людей,\nщо її писали.\n\n**Оновлення ламає гілку, якої ніхто не чіпав.** Код, що вчора проходив, після\nоновлення Ruff повідомляє нові порушення. Звична причина — `select = [\"ALL\"]`,\nщо підхоплює кожне правило, яке додає випуск, разом із версією, яку ніхто не\nзафіксував. Зафіксуйте версію Ruff, щоб оновлення було комітом, який хтось\nпереглядає, і перелічіть потрібні проєкту родини замість `ALL`, щоб нова родина\nз'являлася лише тоді, коли її хтось додасть.\n\n**Одна тека перестає дотримуватися правил проєкту.** Порушення, які коренева\nконфігурація забороняє, проходять у підтеці, або там спрацьовує правило, яке\nрозробники вимкнули. У цій теці лежить `ruff.toml` чи `pyproject.toml` із\nтаблицею `[tool.ruff]`, і оскільки Ruff застосовує найближчий файл цілком, жодне\nкореневе налаштування нижче від нього вже не діє. `ruff check --show-settings`\nдля файлу в цій теці друкує шлях до налаштувань, які він підхопив. Видаліть\nвкладений файл або зробіть так, щоб він успадковував налаштування через\n`extend = \"../pyproject.toml\"`.\n\n**Придушення переживає свою причину.** Коментар `# noqa` з'явився з поважної\nпричини, код змінився, і тепер коментар не ховає нічого або ховає наступну\nпроблему в цьому рядку. Голий `# noqa` ще гірший: він заглушує всі правила в\nрядку. Оберіть RUF100, що повідомляє про коментарі `noqa`, які вже нічого не\nпридушують, і PGH004, що вимагає конкретного коду, і дайте `--fix` прибрати\nмертві. Тут імпорт відтоді почали використовувати, тож коментар нічого не\nзахищає, і RUF100 про нього повідомляє:\n\n```python\nimport json  # noqa: F401\n\nprint(json.dumps({\"ok\": True}))\n```\n\n**Форматувач і лінтер розходяться.** `ruff format` переписує файл, а\n`ruff check` потім позначає результат. Деякі правила лінтера стежать за тим, що\nвирішує форматувач, як-от кінцеві коми (COM812), відступи (W191, E111) і стиль\nлапок (правила Q), а довжини рядка форматувач дотримується лише в міру\nможливого, тож E501 може спрацювати й на відформатованому коді. Читайте\nпопередження, які друкує `ruff format`, бо запуск без них — це власний тест\nдокументації на те, що інструменти узгоджені, ігноруйте кожне правило, яке\nназиває попередження, а E501 сприймайте як сигнал перебудувати рядок.\n\n**Масове виправлення змінює поведінку.** Після `ruff check --fix --unsafe-fixes`\nпо всьому дереву падають тести або обробник помилок перестає ловити те, що ловив\nраніше. Небезпечним виправленням дозволено змінювати поведінку під час виконання\nабо прибирати коментарі, а власний приклад документації змінює, який виняток\nкидає фрагмент коду. Тримайте `--unsafe-fixes` поза хуками й скриптами,\nзастосовуйте небезпечні виправлення по одному правилу через `--select` і читайте\ndiff, а правило переводьте в безпечні через `extend-safe-fixes` лише тоді, коли\nрозробники його перевірили.\n\n## Що почитати далі\n\n- [Ruff](https://docs.astral.sh/ruff/) — що Ruff замінює, наскільки швидким себе\n  заявляє і хто його підтримує.\n- [The Ruff Linter](https://docs.astral.sh/ruff/linter/) — вибір правил і їхній\n  пріоритет, безпечні й небезпечні виправлення, коментарі `noqa` і коди виходу.\n- [The Ruff Formatter](https://docs.astral.sh/ruff/formatter/) — сумісність із\n  Black і правила лінтера, що конфліктують із форматуванням.\n- [Rules](https://docs.astral.sh/ruff/rules/) — кожне правило за кодом, його\n  походження і чи можна виправити його автоматично.\n- [Configuring Ruff](https://docs.astral.sh/ruff/configuration/) — як Ruff\n  знаходить файли, правило найближчого файлу, `extend` і параметри командного\n  рядка.\n\n\u003chttps://engineer.company/uk/glossary/ruff/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як Ruff лінтить і форматує Python однією програмою, як правила вмикають за кодом і чому вкладений файл конфігурації тихо скасовує правила проєкту.","formats":{"gemtext":"https://engineer.company/uk/glossary/ruff/index.gmi","gopher":"https://engineer.company/uk/glossary/ruff/gophermap","html":"https://engineer.company/uk/glossary/ruff/","json":"https://engineer.company/uk/glossary/ruff/index.json","markdown":"https://engineer.company/uk/glossary/ruff/index.md","pdf":"https://engineer.company/uk/glossary/ruff/index.pdf"},"kind":"page","language":"uk","title":"Що таке Ruff?","url":"https://engineer.company/uk/glossary/ruff/","version":1}