{"canonical_url":"https://engineer.company/uk/glossary/linter/","content_markdown":"# Лінтер\n\n## Що це таке\n\nЛінтер — це програма, яка читає вихідний код і вказує на місця, схожі на\nпомилки, не збираючи й не запускаючи програму. Кожне зауваження називає правило,\nфайл і рядок: змінну, якій присвоїли значення й ніде не використали, порівняння,\nщо завжди істинне, змінну оболонки без лапок, рядок формату, зібраний із\nвведення користувача.\n\nНазва походить від lint — засобу перевірки програм мовою C, і NetBSD досі\nпостачає таку утиліту. Її довідка описує завдання як пошук у файлах програм на C\nтих особливостей, які ймовірно є помилками, непереносні або марнотратні, і\nдодає, що типи вона перевіряє суворіше, ніж традиційні компілятори C до C90.\nПрацює вона у два проходи: спершу кожен файл перевіряється як окрема одиниця,\nпотім результати звіряються між файлами в пошуках невідповідностей.\n\nТепер більшість мов мають власні лінтери, часто кілька:\n\n- **ESLint** для JavaScript.\n- **Ruff** для Python.\n- **ShellCheck** для скриптів оболонки. Його заявлені цілі сягають від\n  синтаксичних помилок початківців до тонких пасток, через які робочий скрипт\n  може зламатися за майбутніх обставин.\n- **Stylelint** для CSS, **markdownlint** для Markdown і **yamllint** для YAML.\n\nБудь-який лінтер складається з правил. Кожне правило має ідентифікатор,\nнаприклад F841 у Ruff чи SC2059 у ShellCheck, і рівень серйозності. Файл\nконфігурації визначає, які правила ввімкнено і наскільки серйозне кожне з них, а\nбагато правил мають автоматичне виправлення.\n\nФорматувальник переписує оформлення коду й не має думки щодо змісту; засіб\nперевірки типів міркує про те, чим є кожне значення. Лінтер стоїть між ними й\nдивиться, як код написано: на зловживання можливостями мови, ризиковані шаблони\nй угоди, про які домовилися в проєкті.\n\n## Чому це важливо\n\nЛінтер читає кожну гілку коду, зокрема обробник помилок, що спрацьовує раз на\nрік і до якого не дістається жоден тест. На весь репозиторій йому вистачає\nсекунд, тож його можна запускати під час кожного збереження й кожного коміту, а\nзауваження найдешевше тоді, коли рядок тільки пишуть.\n\nПравила розв'язують суперечку один раз. Чи прийнятний голий `except:`, чи кожну\nзмінну оболонки треба брати в лапки — це вирішують у конфігурації, а далі\nзастосовують однаково до кожного автора й кожного рев'ю. Рецензенти-люди\nзберігають увагу для питань, які правило виразити не здатне.\n\nКод виходу — це інтерфейс між лінтером і тим, що його запускає. README\nShellCheck каже, що інструмент використовує коди виходу канонічним способом,\nтож збірка може викликати його як ще одну команду. Ruff і ESLint документують\nту саму триступеневу угоду: 0, коли перевірка чиста, 1, коли знайдено\nпорушення, і 2, коли збій стався в самому інструменті, наприклад через хибну\nконфігурацію. Тож ворота якості можуть відрізнити «код неправильний» від\n«перевірка зламалася», і обидва випадки мають їх зупинити.\n\nРівень серйозності визначає, які зауваження впливають на код виходу. ESLint\nзавершується успішно, коли знаходить лише попередження, якщо `--max-warnings`\nне задає межу, а в lint(1) є `-w`, щоб вважати попередження помилками. Проєкт,\nякий хоче, щоб лінтери блокували помилки, а не лише описували їх, записує цей\nвибір туди, де його використовує кожен запуск:\n\n```sh\n# кожне зауваження валить запуск, попередження теж\nlint -w -abcFghprSxz source.c\neslint --max-warnings 0 src/\nruff check src/\nshellcheck scripts/*.sh\n```\n\nЦей сайт обрав найсуворіший варіант. Його власні ворота якості вважають кожну\nдіагностику помилкою й забороняють вбудовані придушення на кшталт `# noqa`, тож\nзауваження виправляють у його причині.\n\n## Як це виглядає на практиці\n\nКонфігурація лінтера часто починається з тих правил, які випадково мовчали того\nдня, коли її налаштовували. Одна сторінка робить навпаки:\n[усі правила лінтера Python увімкнено як помилки](/uk/portfolio/enabled-every-linter-rule-as-an-error/).\nПерший прогін дав 1 815 зауважень. Їх опрацьовували за категоріями, а не за\nфайлами, бо категорії самі дещо кажуть: невикористані аргументи й затінені\nвбудовані імена виявилися шумом, а категорії безпеки, змінюваних значень за\nзамовчуванням і обробки винятків указували на реальну поведінку.\nНечисленні винятки мають письмове обґрунтування просто в рядку, а два з них\nпідкріплені тестом, який перевіряє ту властивість, що її забезпечувало б\nвимкнене правило. Поряд у суворому режимі працювала перевірка типів і ловила\nінший різновид дефектів: про те, чим є значення, а не як його записано.\nНазвано й ціну: комусь доводиться ухвалювати рішення 1 815 разів.\n\nІнша сторінка починається з незручного відкриття. Ворота якості сайту,\nтридцять два скрипти й 10 242 рядки JavaScript, були найбільшим масивом коду в\nрепозиторії і єдиним, який не читали ні форматувальник, ні лінтер, ні засіб\nперевірки типів. Щоб\n[підключити код самих воріт до лінтера](/uk/portfolio/linted-the-10242-line-quality-gate-itself/),\nпочали з форматувальника й налаштували для цих файлів відступ у два пробіли,\nтож змінилися 38 рядків замість 2 173. Далі лінтер дав тринадцять реальних\nзауважень, усі виправлені й жодне не придушене, а засіб перевірки типів знайшов\nдва дефекти, які лінтер пропустив. Пояснення, навіщо це, теж є: дефект у\nперевірці проявляється як перевірка, що проходить тоді, коли мала б упасти.\n\nІдея працює й для тексту. Третя сторінка описує\n[лінтер для власної документації репозиторію](/uk/portfolio/put-the-documentation-under-its-own-linter/)\nз межами, які спричиняють збій, а не лише дають пораду. Серед його восьми\nмеханічних політик — бюджет рядків для кожного файлу, який може лише\nзменшуватися, правило, що заявлений статус плану має збігатися з його власними\nпрапорцями, і перевірка, що кожен шлях і символ коду, згаданий у документі,\nіснує в дереві. Перший запуск виявив шість планів, позначених виконаними, з\nневідміченими прапорцями, чотирнадцять завдань, що перевіряли кожен коміт, але\nне згадувалися в жодному документі, три биті посилання, один документ-сироту й\nтри мертві шляхи.\n\n## Де виникають проблеми\n\nЛінтер рідко ламається гучно. Звичайна вада — запуск, що завершується з кодом 0,\nхоча мав би щось зупинити.\n\n**Зауваження, які ніколи не змінюють код виходу.** `--max-warnings` в ESLint за\nзамовчуванням дорівнює -1, тобто межу вимкнено, а за довідкою lint(1) прохід\nперехресної перевірки між файлами завжди завершується успішно. Зауваження, яке\nне може провалити запуск, читають один раз, а потім прокручують. Вирішуйте для\nкожного правила: або помилка, що валить запуск, або вимкнено, а будь-який\nперемикач «попередження як помилки» тримайте в спільній конфігурації.\n\n**Виправлення, яке звітує про успіх.** Ruff завершується з 0, коли кожне\nзнайдене порушення виправлено автоматично. За робочим столом це зручно, але\nворота, що працюють з увімкненими виправленнями, лагодять лише власну робочу\nкопію, а коміт, який надійшов, і далі містить кожне порушення. Запускайте\nперевірку без виправлень або додайте `--exit-non-zero-on-fix`, щоб виправлення\nвважалося збоєм. Пошукайте також `--exit-zero`: з ним Ruff завершується з 0,\nнавіть коли порушення є, а прапорець, доданий на час одного переходу з купою\nпорушень, має звичку залишатися.\n\n**Шаблон, що охоплює нуль файлів.** Перейменований каталог чи перенесена\nконфігурація можуть залишити лінтер націленим на порожню множину, а перевірка\nнуля файлів — чистий результат. ESLint за замовчуванням вважає помилкою glob у\nлапках, під який не потрапляє жоден файл. `--no-error-on-unmatched-pattern`\nперетворює це на тихий успіх, а `--pass-on-no-patterns` завершується з 0, коли\nшаблонів файлів не передано зовсім. Залиште поведінку за замовчуванням і\nтримайте один файл із відомим порушенням, про яке ворота мусять повідомити.\n\n**Набір правил, обраний за тим, що мовчало.** Конфігурація, зібрана вимиканням\nусього, що спрацювало першого дня, фіксує звички коду, а не стандарт. Почніть\nзі свідомого вибору: або все одразу, або запропонована Ruff невелика база з `E`\nі `F`, до якої щоразу додають по одній групі, — і запишіть, чому вимкнено кожне\nвимкнене правило. Ruff попереджає, що `ALL` неявно вмикає нові правила після\nкожного оновлення інструмента, тож зафіксуйте версію лінтера й оновлюйте її\nокремою зміною.\n\n**Придушення поширюються по одному рядку.** Кожен лінтер має запасний вихід:\n`/* LINTED */` у lint(1), `# noqa: F841` у Ruff,\n`# shellcheck disable=SC2059` у ShellCheck і `// eslint-disable-next-line` в\nESLint. Кожен із них фіксує, що саме заглушили, але не чому. Вимагайте\nписьмового обґрунтування біля кожного винятку, а для важливих вимкніть правило й\nдодайте тест на властивість, яку воно захищало. Допомагає й тримати винятки в\nодному місці: `--no-inline-config` в ESLint робить коментарі вимкнення\nнедієвими, а ShellCheck читає рядки `disable` для всього проєкту з файлу\n`.shellcheckrc`.\n\n## Що почитати далі\n\n- [lint(1)](https://man.netbsd.org/lint.1) — довідка NetBSD до засобу перевірки\n  C, від якого походить слово: два проходи, `-w` і коментарі для придушення.\n- [The Ruff Linter](https://docs.astral.sh/ruff/linter/) — вибір правил,\n  безпечні й небезпечні виправлення, коментарі придушення й коди виходу.\n- [Command Line Interface Reference](https://eslint.org/docs/latest/use/command-line-interface)\n  — `--max-warnings` в ESLint, вбудована конфігурація, шаблони без збігів і\n  коди виходу.\n- [ShellCheck](https://github.com/koalaman/shellcheck) — README проєкту: що\n  інструмент шукає і як він вписується у збірку.\n- [Ignore](https://github.com/koalaman/shellcheck/wiki/Ignore) — способи\n  ShellCheck ігнорувати зауваження для рядка, запуску чи цілого проєкту.\n\n\u003chttps://engineer.company/uk/glossary/linter/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що лінтер перевіряє без запуску коду, як правила, рівні серйозності й коди виходу вирішують долю збірки і як лінтинг проходить, щось пропустивши.","formats":{"gemtext":"https://engineer.company/uk/glossary/linter/index.gmi","gopher":"https://engineer.company/uk/glossary/linter/gophermap","html":"https://engineer.company/uk/glossary/linter/","json":"https://engineer.company/uk/glossary/linter/index.json","markdown":"https://engineer.company/uk/glossary/linter/index.md","pdf":"https://engineer.company/uk/glossary/linter/index.pdf"},"kind":"page","language":"uk","title":"Що таке лінтер?","url":"https://engineer.company/uk/glossary/linter/","version":1}