ESLint-Config-Generator
Beantworte ein paar Fragen zu deinem Projekt und erhalte eine moderne Flat Config eslint.config.js für ESLint 9 sowie die genauen Pakete, die du installieren musst. Abgedeckt sind JavaScript und TypeScript (inklusive typbasiertem Linting), React mit Hooks- und Barrierefreiheitsregeln, Node.js, Test-Globals und Prettier.
Zuletzt aktualisiert:
eslint.config.js
Anleitung: ESLint-Config-Generator
- Wähle ein Schnellstart-Preset wie React + TypeScript oder Node.js oder stelle die Optionen selbst ein.
- Wähle Sprache und Framework: TypeScript fügt typescript-eslint hinzu, React fügt die React-, Hooks- und optional die Barrierefreiheits-Plugins hinzu.
- Wähle die Umgebung (Browser, Node.js, Test-Globals) und ob deine Dateien ES-Module oder CommonJS verwenden.
- Schalte zusätzliche Regeln und die Prettier-Kompatibilität ein und gib Ordner an, die ignoriert werden sollen.
- Kopiere die Config und den Installbefehl, speichere die Datei im Stammverzeichnis deines Projekts und führe
npx eslint .aus.
Welche Pakete fügt jede Option hinzu?
| Option | Paket | Was sie zur Config hinzufügt |
|---|---|---|
| Immer | eslint, @eslint/js, globals | js.configs.recommended und Umgebungs-Globals |
| TypeScript | typescript-eslint, typescript | Parser, Plugin und der Regelsatz recommended oder strict |
| React | eslint-plugin-react | react.configs.flat.recommended und die jsx-runtime-Config für React 17+ |
| Rules of Hooks | eslint-plugin-react-hooks | rules-of-hooks (Fehler) und exhaustive-deps (Warnung) |
| Barrierefreiheit | eslint-plugin-jsx-a11y | Prüft Alt-Texte, Labels, gültiges ARIA und Tastaturunterstützung in JSX |
| Node.js-Best-Practices | eslint-plugin-n | Fehlende Imports, nicht unterstützte Node.js-Funktionen, veraltete APIs |
| Prettier | eslint-config-prettier | Schaltet Regeln ab, die mit der Prettier-Formatierung kollidieren |
Umstieg von .eslintrc auf Flat Config
- Aus
extends-Strings werden Imports. Aus"extends": ["eslint:recommended"]wirdjs.configs.recommended, importiert aus@eslint/js. - Aus
envwirdlanguageOptions.globals. Aus"env": { "browser": true }wirdglobals: { ...globals.browser }. - Aus
overrideswerden eigene Objekte mit eigenemfiles-Muster, die der Reihe nach angewendet werden. - Aus
.eslintignorewirdignoresin der Config-Datei. - Die Schweregrade der Regeln bleiben gleich:
"off","warn","error"(oder 0, 1, 2), optional mit Optionen in einem Array.
Formatierung gehört in einen Formatter: Erstelle eine passende Config mit dem Prettier-Config-Generator und halte die Einrückung in allen Editoren einheitlich mit dem EditorConfig-Generator.
Häufige Fragen
Was ist die ESLint Flat Config?
Flat Config ist das Konfigurationsformat, das mit ESLint 8.21 eingeführt und in ESLint 9 zum Standard wurde. Statt .eslintrc-Dateien mit extends-Strings exportierst du aus eslint.config.js ein Array von Config-Objekten und importierst Plugins und geteilte Configs direkt als JavaScript-Module.
Soll meine Datei eslint.config.js oder eslint.config.mjs heißen?
Verwende eslint.config.js, wenn deine package.json "type": "module" enthält, denn die Datei nutzt import und export. In einem CommonJS-Projekt nennst du sie entweder eslint.config.mjs, die immer als ES-Modul behandelt wird, oder wählst eslint.config.cjs, um require und module.exports zu verwenden.
Was macht defineConfig?
defineConfig() aus eslint/config (ESLint 9.22 und neuer) ergänzt eine Typprüfung und akzeptiert verschachtelte Arrays, sodass geteilte Configs wie tseslint.configs.recommended ohne Spread-Operator aufgeführt werden können. globalIgnores() macht deutlich, dass die Muster für das ganze Projekt gelten. Deaktiviere die Option, um ein einfaches exportiertes Array für ältere ESLint-9-Versionen zu erhalten.
Was ist typbasiertes Linting?
typescript-eslint kann die Typinformationen des TypeScript-Compilers für Regeln wie no-floating-promises und no-misused-promises nutzen. Dafür ist eine tsconfig.json nötig, und das Linting wird langsamer. Die erzeugte Config aktiviert projectService und schaltet typbasierte Regeln für reine .js-Dateien ab.
Wie nutze ich ESLint zusammen mit Prettier?
Überlasse Prettier die Formatierung und ESLint die Codequalität. Aktiviere die Prettier-Option, um eslint-config-prettier als letztes Element hinzuzufügen. Das schaltet alle ESLint-Regeln ab, die mit der Ausgabe von Prettier kollidieren könnten. Führe Prettier separat oder beim Speichern in deinem Editor aus.
Wo ist .eslintignore geblieben?
Flat Config liest keine .eslintignore. Trage ignorierte Pfade stattdessen in die Config ein, als Objekt nur mit einem ignores-Schlüssel oder mit globalIgnores(). node_modules und .git werden automatisch ignoriert.
Wird etwas hochgeladen?
Nein. Die Konfiguration wird in deinem Browser erzeugt, und deine Auswahl wird nur im lokalen Speicher dieses Browsers gespeichert.
Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?
Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.