Ein Linter ist das friedlichste Werkzeug zur Durchsetzung von Codestil, weil er nicht urteilt, sondern nur meldet.
Linting fuehlt sich schnell nach Kontrolle an, besonders wenn es top-down eingefuehrt wird, ohne das Team einzubinden. Die Loesung: Das Team entscheidet gemeinsam ueber die Regeln, dann akzeptiert es sie auch.
Passende Linter je nach Stack
Fuer PHP eignen sich PHP_CodeSniffer, PHP-CS-Fixer und PHPStan mit progressiv strengeren Levels. Fuer JavaScript und TypeScript ist ESLint mit einer etablierten Konfiguration Standard. Fuer CSS und SCSS uebernimmt Stylelint diese Rolle, fuer Templates hilft Prettier mit passendem Plugin.
Progressive Einfuehrung in bestehenden Projekten
Bei fuenfhundert bestehenden Linting-Fehlern ergibt es keinen Sinn, alle auf einmal zu fixen. Sinnvoller ist eine Baseline, die aktuelle Fehler zunaechst ignoriert, neue Regeln nur fuer neue oder geaenderte Dateien durchsetzt, und die Baseline mit der Zeit schrittweise reduziert.
Auto-Fix konsequent nutzen
Viele Linting-Fehler lassen sich automatisch beheben. Das spart Zeit und nimmt viel Reibung aus dem Prozess. Was nicht automatisch fixbar ist, sollte sparsam geregelt werden.
CI-Integration macht es verbindlich
Kein Merge ohne gruenen Lint-Check nimmt die Diskussion aus dem Code-Review, der Linter hat entschieden, nicht der Reviewer.
Checkliste: Linter fuer alle verwendeten Sprachen konfiguriert, Regeln im Team abgestimmt, progressive Einfuehrung mit Baseline, Auto-Fix in der Editor-Integration aktiv, CI blockiert bei Linting-Fehlern, Pre-Commit Hook als letztes Sicherheitsnetz.
Ein Beispiel aus der Praxis
Ein Team fuehrte Linting mit einer sofort scharf gestellten, sehr strengen Regelkonfiguration ein und stiess dabei auf ueber zweitausend bestehende Fehler. Die Reaktion war Frust und die stille Abschaltung des Linters in der CI nach zwei Wochen. Beim zweiten Anlauf wurde stattdessen eine Baseline gesetzt, die alle bestehenden Fehler zunaechst ignorierte, waehrend neue Regeln nur fuer neu geschriebenen Code galten. Diesmal blieb der Linter dauerhaft aktiv, weil niemand durch eine unmoegliche Altlast entmutigt wurde.
Linting-Setup fuer euer Projekt? markom.digital richtet Linting-Konfigurationen pragmatisch ein, ohne Over-Engineering.
