{"canonical_url":"https://engineer.company/uk/glossary/git-hook/","content_markdown":"# хук\n\n## Що це таке\n\nХук — це програма, яку git сам запускає у фіксованій точці власної роботи: перед\nтим як коміт буде записано, коли повідомлення коміту вже написано, перед тим як\nпуш залишить машину, або коли сервер його отримує. Кожен хук — це файл, названий\nза своєю миттю, наприклад `pre-commit`, `commit-msg` чи `pre-push`, без\nрозширення. Усталено git шукає їх у `.git/hooks` усередині репозиторію, а\nпараметр `core.hooksPath` вказує йому інше місце. Файл має бути виконуваним, бо\nфайл без біта виконання git ігнорує, але написати його можна будь-якою мовою,\nяку машина вміє запускати.\n\nКлієнтські хуки працюють у власному клоні розробника і спрацьовують на такі\nоперації, як коміт і злиття. Серверні хуки працюють на машині, що приймає пуші,\nнаприклад на форджі, і спрацьовують, коли надіслані коміти надходять.\n\nВартовим, а не просто сповіщенням, хук робить його код завершення. Хук\n`pre-commit` не отримує аргументів, і ненульовий код завершення перериває коміт.\nХук `commit-msg` отримує шлях до файлу із запропонованим повідомленням і може\nвідхилити повідомлення або змінити його. Хук `pre-push` отримує як аргументи\nназву й адресу віддаленого репозиторію, а на стандартний вхід — по одному рядку\nна кожне посилання, і ненульовий код завершення зупиняє пуш, перш ніж щось буде\nнадіслано. На сервері `pre-receive` запускається один раз на пуш і читає для\nкожного посилання стару назву об'єкта, нову назву об'єкта та назву посилання, а\nякщо він завершується з ненульовим кодом, жодне з посилань не оновлюється. Хуки,\nщо працюють після події, як-от `post-commit`, призначені для сповіщень і не\nможуть змінити її наслідок.\n\nКоли `git init` створює репозиторій, він заповнює каталог хуків прикладами\nскриптів, назви яких закінчуються на `.sample`. git запускає такий скрипт лише\nпісля того, як його перейменують без цього суфікса.\n\n## Чому це важливо\n\nХук перетворює перевірку, про яку хтось має пам'ятати, на таку, що відбувається\nсама, і в найдешевшу мить. Форматер або сканер секретів, що працює під час\nстворення коміту, ловить проблему, поки зміна ще свіжа в голові автора, а не на\nрев'ю через кілька днів чи в запуску CI, коли роботою вже поділилися з іншими.\n\nХуки — це також спосіб зробити правило властивістю репозиторію, а не того, хто\nвипадково робить коміт. Домовленість у посібнику для учасників тримається лише\nдоти, доки люди цей посібник читають; та сама домовленість у хуку `commit-msg`\nдіє для кожного коміту.\n\nДві групи хуків можуть обіцяти різне. Книжка Pro Git нагадує, що клієнтські хуки\nне копіюються під час клонування репозиторію, і радить забезпечувати дотримання\nправил на боці сервера. Серверний хук, як-от `pre-receive`, діє на кожен пуш від\nусіх, хоч би що вони встановили в себе. Ціна — час: хук працює на кожному коміті\nчи кожному пуші, а перевірка, через яку коміт стає повільним, спокушає людей її\nоминути.\n\n## Як це виглядає на практиці\n\nРепозиторій цього сайту встановлює свої хуки через фреймворк pre-commit: їх\nналаштовано у `.pre-commit-config.yaml`, а встановлює їх `task setup`, який\nвиконує `pre-commit install --install-hooks`. Файл встановлює три хуки git. На\nетапі pre-commit він запускає Prettier, markdownlint, stylelint, yamllint,\ncodespell, перевірки лінтування й форматування Ruff, пошук секретів gitleaks,\nперевірку на емодзі та перевірку тону. На етапі\ncommit-msg він запускає один скрипт, що тримає повідомлення в конвенційній формі\nбез емодзі. На етапі pre-push він запускає всю перевірку якості, `task check`,\nяка триває хвилини, а не секунди; коментар біля хука pre-push вважає, що цю ціну\nварто платити, бо пуш буває рідко. Вступ файлу велить ніколи не оминати хуки за\nдопомогою `--no-verify`, і коментар цього дотримується: пуш, який не може\nчекати, ще не готовий.\n\nХук повідомлень комітів також тримає\n[чотири репозиторії на одному стандарті історії](/uk/portfolio/held-4-repositories-to-one-history-standard/):\nконвенційний префікс і область, тема не довша за фіксовану довжину, без емодзі й\nбез рядків атрибуції. Хук відхиляє все, що відступає від стандарту, у кожному\nрепозиторії, де ведеться робота, тож стандарт належить репозиторію, а не тому,\nхто робить коміт.\n\n[Серверний хук для власної форджі компанії відрепетирували](/uk/portfolio/rehearsed-the-forge-ci-hook-found-2-defects/),\nперш ніж до нього дійшов справжній пуш. Такий хук виконується в bare-репозиторії\nбез робочого дерева, у середовищі, яке задає форджа, і читає надіслані посилання\nзі стандартного входу, тож запуск вручну на ноутбуці мало що доводить. Репетиція\nстворює bare-репозиторій, встановлює хук, клонує, робить коміт і пуш, а потім\nперевіряє і сценарій прийняття, і сценарій відхилення. Вона знайшла два дефекти,\nяких не було видно у файлі; обидва описано нижче.\n\nВ одному проєкті\n[хук коміту і ворота якості, як з'ясувалося, виконували різні перевірки](/uk/portfolio/found-the-hooks-and-the-gate-disagreeing/),\nхоча документ стверджував, що хук виконує всю перевірку якості. Тепер тест\nзводить обидва переліки до перевірок, які вони насправді викликають, і падає,\nщойно ці набори розходяться. П'ять перевірок, які працювали лише у воротах\nякості, були саме тими, що читали текст CV, тож код охоронявся на кожному\nкоміті, а текст — лише тоді, коли хтось про це згадував.\n\nКлієнтському хуку фреймворк узагалі не потрібен. Цей хук, збережений як\n`.git/hooks/commit-msg` і зроблений виконуваним, відхиляє коміт, тема якого не\nпочинається з конвенційного типу:\n\n```sh\n#!/bin/sh\n# git передає шлях до запропонованого повідомлення коміту як $1\npattern='^(feat|fix|docs|chore)(\\([a-z0-9-]+\\))?: .+'\nif head -n 1 \"$1\" | grep -Eq \"$pattern\"; then\n    exit 0\nfi\necho \"commit-msg: почніть тему з типу, як у 'fix(nav): ...'\" \u003e\u00262\nexit 1\n```\n\n## Де виникають проблеми\n\n- **Свіжий клон приходить без хуків.** Кожен клон має встановити їх сам, і тут\n  цю роботу виконує `task setup`. Коментар у `Taskfile.yml` цього сайту описує\n  тиху версію збою: без `pre-commit` на машині `task setup` нічого не\n  встановлює, кожен хук мовчки не запускається, а результат виглядає точнісінько\n  як репозиторій, що проходить перевірки.\n- **`--no-verify` проходить просто повз них.** `git commit --no-verify` оминає\n  хуки `pre-commit` і `commit-msg`, `git push --no-verify` оминає `pre-push`, а\n  якщо встановити `core.hooksPath` у `/dev/null`, вимикаються всі хуки одразу.\n  Правилу, яке мусить діяти, місце також у серверному хуку.\n- **Середовище git іде за хуком в інші репозиторії.** git експортує змінні,\n  як-от `GIT_DIR`, щоб команди git у хуку знаходили потрібний репозиторій, і\n  githooks(5) радить очищати їх, коли хук працює з іншим репозиторієм. Репетиція\n  на форджі натрапила саме на це: ворота якості створили робочу копію надісланої ревізії й\n  запустили в ній тести, тести успадкували вказівник git на bare-репозиторій, і\n  дев'ятнадцять із них стали червоними на правильному коді.\n- **Стандартний вхід несе крайні випадки.** Другий дефект репетиції — запасний\n  варіант, який, коли посилання для роботи не було, підставляв заповнювач, що\n  його git не може розв'язати; оскільки значення надходить на стандартний вхід,\n  збій проявлявся значно далі як не пов'язана з ним помилка. Сторінка також\n  зазначає, що форджа бачитиме примусові оновлення й видалення гілок, яких\n  репетиція не відтворює. За githooks(5), видалене посилання надходить до\n  `pre-push` як `(delete)` з назвою об'єкта з самих нулів.\n- **Повільний хук оминають.** Щоб перенести п'ять перевірок тексту в хук коміту,\n  дві з них довелося пришвидшити настільки, щоб вони вкладалися в бюджет часу\n  pre-commit, і та сторінка прямо каже, що час роботи зростає разом із вмістом і\n  що з певного моменту повільний хук починають обходити.\n- **Формат проходить, а зміст лишається неперевіреним.** Як каже сторінка про\n  чотири репозиторії, формат перевіряється, а зміст — ні, тож тема у правильному\n  форматі, яка нічого не описує, проходить так само успішно, як та, що пояснює\n  зміну.\n\n## Що почитати далі\n\n- [githooks documentation](https://git-scm.com/docs/githooks) — усі хуки, які\n  підтримує git, коли кожен із них запускається, що отримує і що вирішує його\n  код завершення.\n- [Pro Git: Git Hooks](https://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks)\n  — клієнтські й серверні хуки, як установити хук і чому клон їх не переносить.\n- [Pro Git: An Example Git-Enforced Policy](https://git-scm.com/book/en/v2/Customizing-Git-An-Example-Git-Enforced-Policy)\n  — серверний хук `update`, що забезпечує формат повідомлень і правила доступу,\n  разом із клієнтськими хуками, які попереджають до пушу.\n- [git config](https://git-scm.com/docs/git-config) — параметр `core.hooksPath`,\n  щоб перенести хуки з `.git/hooks` або вимкнути їх усі.\n- [git commit](https://git-scm.com/docs/git-commit) — параметр `--no-verify` і\n  два хуки, які він оминає.\n- [git push](https://git-scm.com/docs/git-push) — хук `pre-push` і параметр\n  `--no-verify`, що його пропускає.\n\n\u003chttps://engineer.company/uk/glossary/git-hook/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як хуки git зупиняють невдалий коміт або пуш у ту саму мить, чому свіжий клон приходить без них і як їх непомітно оминають.","formats":{"gemtext":"https://engineer.company/uk/glossary/git-hook/index.gmi","gopher":"https://engineer.company/uk/glossary/git-hook/gophermap","html":"https://engineer.company/uk/glossary/git-hook/","json":"https://engineer.company/uk/glossary/git-hook/index.json","markdown":"https://engineer.company/uk/glossary/git-hook/index.md","pdf":"https://engineer.company/uk/glossary/git-hook/index.pdf"},"kind":"page","language":"uk","title":"Що таке хук?","url":"https://engineer.company/uk/glossary/git-hook/","version":1}