{"canonical_url":"https://engineer.company/de/glossary/git-hook/","content_markdown":"# Git-Hook\n\n## Was es ist\n\nEin Git-Hook ist ein Programm, das Git selbst an einem festgelegten Punkt\nseiner Arbeit startet: bevor ein Commit aufgezeichnet wird, nachdem eine\nCommit-Nachricht geschrieben wurde, bevor ein Push den Rechner verlässt\noder wenn ein Server einen empfängt. Jeder Hook ist eine Datei ohne Endung,\ndie nach diesem Zeitpunkt benannt ist, etwa `pre-commit`, `commit-msg` oder\n`pre-push`. Standardmäßig sucht Git im Verzeichnis `.git/hooks` des\nRepositorys danach; mit `core.hooksPath` lässt sich ein anderer Ort angeben.\nDie Datei muss ausführbar sein, denn Git ignoriert sie ohne gesetztes\nAusführungsbit. Sie kann aber in jeder Sprache geschrieben sein, die der\nRechner ausführen kann.\n\nClientseitige Hooks laufen im eigenen Klon eines Entwicklers und werden bei\nVorgängen wie Commits und Merges ausgelöst. Serverseitige Hooks laufen auf\ndem Rechner, der Pushes empfängt, etwa einer Forge, und werden ausgelöst,\nwenn gepushte Commits eintreffen.\n\nSein Rückgabestatus macht aus einem Hook zur Benachrichtigung einen Hook\nzum Durchsetzen von Regeln. Der Hook `pre-commit` erhält keine Argumente.\nEin Rückgabestatus ungleich null bricht den Commit ab. `commit-msg` erhält den Pfad einer Datei\nmit der vorgeschlagenen Nachricht und kann sie ablehnen oder bearbeiten.\n`pre-push` erhält den Namen und die Adresse des Remotes als Argumente sowie\nüber die Standardeingabe eine Zeile je Referenz. Ein Status ungleich null\nstoppt den Push, bevor etwas gesendet wird. Auf dem Server läuft `pre-receive`\neinmal je Push. Er liest für jede Referenz den alten Objektnamen, den neuen\nObjektnamen und den Referenznamen. Endet er mit einem Status ungleich null,\nwird keine der Referenzen aktualisiert. Nach dem Ereignis laufende Hooks wie\n`post-commit` dienen der Benachrichtigung und können das Ergebnis nicht mehr\nändern.\n\nWenn `git init` ein Repository anlegt, füllt es das Hook-Verzeichnis mit\nBeispielskripten, deren Namen auf `.sample` enden. Git führt ein solches\nSkript erst aus, nachdem diese Endung beim Umbenennen entfernt wurde.\n\n## Warum es wichtig ist\n\nEin Hook macht aus einer Prüfung, an die jemand denken muss, eine Prüfung,\ndie von selbst und zum günstigsten Zeitpunkt stattfindet. Ein Formatierer\noder ein Secret-Scanner, der beim Erstellen des Commits läuft,\nfindet ein Problem, solange der Autor die Änderung noch im Kopf hat. Es fällt\ndann nicht erst Tage später im Review oder nach dem Teilen der Arbeit in\neinem CI-Lauf auf.\n\nHooks machen eine Regel außerdem zu einer Eigenschaft des Repositorys und\nlösen sie von der Person, die gerade committet. Eine Konvention in einem\nLeitfaden für Mitwirkende gilt nur, solange die Leute ihn lesen. Dieselbe\nKonvention in einem Hook vom Typ `commit-msg` gilt für jeden Commit.\n\nDie beiden Gruppen unterscheiden sich darin, wie viel sie versprechen\nkönnen. Das Buch Pro Git weist darauf hin, dass beim Klonen eines Repositorys\ndessen clientseitige Hooks nicht kopiert werden, und empfiehlt, Regeln auf\nder Serverseite durchzusetzen. Ein serverseitiger Hook wie `pre-receive`\ngilt für jeden Push von jedem Mitwirkenden, unabhängig von dessen lokaler\nInstallation. Der Preis ist Zeit: Ein Hook läuft bei jedem Commit oder jedem\nPush. Eine Prüfung, die Commits verlangsamt, lädt zum Umgehen ein.\n\n## Wie es in der Praxis aussieht\n\nDas Repository dieser Website installiert seine Hooks über das Framework\npre-commit. Die Konfiguration steht in `.pre-commit-config.yaml`; die Hooks\ninstalliert `task setup`, das `pre-commit install --install-hooks` ausführt.\nDie Datei installiert drei Git-Hooks. In der pre-commit-Phase laufen Prettier,\nmarkdownlint, stylelint, yamllint, codespell, Ruffs Lint- und Formatprüfungen,\nein gitleaks-Scan nach Geheimnissen, eine Emoji-Prüfung und eine Prüfung\ndes sprachlichen Tons.\nIn der commit-msg-Phase erzwingt ein Skript eine konventionelle Form\nder Nachrichten ohne Emojis. In der pre-push-Phase läuft die gesamte\nverbindliche Qualitätsprüfung, `task check`. Sie dauert Minuten statt\nSekunden. Der Kommentar zu diesem Hook akzeptiert den Preis, weil ein Push\nselten ist. Der Dateikopf verbietet das Umgehen der Hooks mit `--no-verify`,\nund der Kommentar bleibt dabei: Ein Push, der nicht warten kann, ist nicht\nbereit.\n\nEin Hook für Commit-Nachrichten setzt außerdem\n[für vier Repositorys einen gemeinsamen Standard für die Historie](/de/portfolio/held-4-repositories-to-one-history-standard/)\ndurch:\nein konventionelles Präfix mit Geltungsbereich, eine Betreffzeile unter einer\nfestgelegten Länge, keine Emojis und keine Attribution-Trailer. Der Hook lehnt\nalles ab, was davon abweicht, und zwar in jedem Repository, das Arbeit\nenthält. Der Standard gehört damit zum Repository und nicht zur jeweils\ncommittenden Person.\n\n[Ein serverseitiger Hook für die unternehmenseigene Forge wurde erprobt](/de/portfolio/rehearsed-the-forge-ci-hook-found-2-defects/),\nbevor ihn ein echter Push erreichte. Ein solcher Hook läuft in einem\nBare-Repository ohne Arbeitsbaum, in einer von der Forge gesetzten\nUmgebung, und liest gepushte Referenzen über die Standardeingabe. Ihn von\nHand auf einem Laptop auszuführen, beweist deshalb wenig. Die Erprobung legt\nein Bare-Repository an, installiert den Hook, klont, committet und pusht und\nprüft sowohl den Annahme- als auch den Ablehnungspfad. Dabei wurden zwei\nFehler gefunden, die beim Lesen der Datei nicht erkennbar waren. Beide werden\nunten beschrieben.\n\nIn einem Projekt stellte sich heraus, dass\n[Commit-Hook und Qualitätsprüfung unterschiedliche Prüfungen ausführten](/de/portfolio/found-the-hooks-and-the-gate-disagreeing/),\nobwohl ein Dokument behauptete, der Hook führe die Qualitätsprüfung aus.\nEin Test ermittelt nun für beide die tatsächlich aufgerufenen Prüfungen und\nschlägt fehl, wenn die Mengen auseinanderfallen. Die fünf Prüfungen, die nur\nin der Qualitätsprüfung gelaufen waren, lasen die Lebenslauftexte. Der Code\nwar somit bei jedem Commit geschützt, die Texte nur, wenn jemand daran dachte.\n\nEin clientseitiger Hook braucht überhaupt kein Framework. Dieser hier,\ngespeichert als `.git/hooks/commit-msg` und ausführbar gemacht, lehnt einen\nCommit ab, dessen Betreff nicht mit einem konventionellen Typ beginnt:\n\n```sh\n#!/bin/sh\n# git passes the path of the proposed commit message as $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: start the subject with a type, as in 'fix(nav): ...'\" \u003e\u00262\nexit 1\n```\n\n## Wo es schiefgeht\n\n- **Ein frischer Klon kommt ohne Hooks an.** Jeder Klon muss sie installieren.\n  Hier erledigt das `task setup`. Ein Kommentar in der `Taskfile.yml` dieser\n  Website beschreibt die unauffällige Form des Fehlers: Ohne `pre-commit` auf\n  dem Rechner installiert `task setup` nichts, sämtliche Hooks bleiben\n  stillschweigend aus, und das Ergebnis sieht genauso aus wie ein Repository,\n  das alle Prüfungen besteht.\n- **`--no-verify` geht geradewegs an ihnen vorbei.**\n  `git commit --no-verify` umgeht `pre-commit` und `commit-msg`,\n  `git push --no-verify` umgeht `pre-push`, und `core.hooksPath` auf\n  `/dev/null` zu setzen, schaltet alle Hooks zugleich ab. Eine Regel, die\n  gelten muss, gehört auch in einen serverseitigen Hook.\n- **Gits Umgebung folgt dem Hook in andere Repositorys.** Git exportiert\n  Variablen wie `GIT_DIR`, damit Git-Befehle in einem Hook das richtige\n  Repository finden. githooks(5) empfiehlt, sie zu entfernen, wenn ein Hook\n  in einem anderen arbeitet. Genau das trat bei der Forge-Erprobung auf: Die\n  Qualitätsprüfung checkte die gepushte Revision aus und führte darin die\n  Tests aus. Diese erbten Gits Verweis auf das Bare-Repository, und neunzehn\n  von ihnen schlugen bei korrektem Code fehl.\n- **Die Standardeingabe transportiert die Randfälle.** Der andere Fehler der\n  Erprobung lag in einer Ausweichlösung, die mangels einer verwendbaren\n  Referenz einen von Git nicht auflösbaren Platzhalter einsetzte. Weil der\n  Wert über die Standardeingabe ankommt, erschien der Fehler erst viel später\n  als scheinbar unzusammenhängende Fehlermeldung. Die Seite hält außerdem\n  fest, dass die Forge erzwungene Aktualisierungen und gelöschte Branches\n  sehen wird, die die Erprobung nicht nachstellt. Laut githooks(5) erreicht\n  eine gelöschte Referenz `pre-push` als `(delete)` mit einem ausschließlich\n  aus Nullen bestehenden Objektnamen.\n- **Ein langsamer Hook wird umgangen.** Die fünf Textprüfungen in den\n  Commit-Hook aufzunehmen, erforderte, zwei davon für das Zeitbudget eines\n  pre-commit-Hooks schnell genug zu machen. Die Seite sagt deutlich, dass\n  die Laufzeit mit dem Inhalt wächst und irgendwann der Punkt erreicht ist,\n  an dem ein langsamer Hook umgangen wird.\n- **Das Format passt, die Bedeutung bleibt ungeprüft.** Wie die Seite über\n  die vier Repositorys sagt: Das Format wird geprüft, der Inhalt nicht.\n  Eine formal passende Betreffzeile, die nichts beschreibt, besteht daher\n  genauso wie eine, die die Änderung erklärt.\n\n## Weiterführende Lektüre\n\n- [githooks-Dokumentation](https://git-scm.com/docs/githooks) — sämtliche von\n  Git unterstützten Hooks, ihre Ausführungszeitpunkte, ihre Eingaben und die\n  Entscheidungen, die ihr Rückgabestatus trifft.\n- [Pro Git: Git-Hooks](https://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks)\n  — clientseitige und serverseitige Hooks, ihre Installation und warum sie\n  beim Klonen zurückbleiben.\n- [Pro Git: Beispiel einer durch Git erzwungenen Richtlinie](https://git-scm.com/book/en/v2/Customizing-Git-An-Example-Git-Enforced-Policy)\n  — ein serverseitiger Hook vom Typ `update`, der ein Nachrichtenformat und\n  Zugriffsregeln durchsetzt, mit clientseitigen Hooks, die vor dem Push warnen.\n- [git config](https://git-scm.com/docs/git-config) — die Einstellung\n  `core.hooksPath`, um Hooks aus `.git/hooks` zu verlagern oder alle abzuschalten.\n- [git commit](https://git-scm.com/docs/git-commit) — die Option `--no-verify`\n  und die zwei Hooks, die sie umgeht.\n- [git push](https://git-scm.com/docs/git-push) — der Hook `pre-push` und die\n  Option `--no-verify`, die ihn überspringt.\n\n\u003chttps://engineer.company/de/glossary/git-hook/\u003e\n","date_modified":"2026-11-08T09:42:23Z","description":"Wie Git-Hooks fehlerhafte Commits und Pushes sofort stoppen, warum sie beim Klonen fehlen und auf welchen Wegen sie unbemerkt ausbleiben.","formats":{"gemtext":"https://engineer.company/de/glossary/git-hook/index.gmi","gopher":"https://engineer.company/de/glossary/git-hook/gophermap","html":"https://engineer.company/de/glossary/git-hook/","json":"https://engineer.company/de/glossary/git-hook/index.json","markdown":"https://engineer.company/de/glossary/git-hook/index.md","pdf":"https://engineer.company/de/glossary/git-hook/index.pdf"},"kind":"page","language":"de","title":"Was ist ein Git-Hook?","url":"https://engineer.company/de/glossary/git-hook/","version":1}