tsconfig.json-Generator
Wähle eine Startvorlage, passe die Compiler-Optionen an und erhalte eine saubere tsconfig.json mit Kommentaren. Jede aktivierte Option wird in einfachen Worten erklärt, und widersprüchliche Einstellungen wie ein unpassendes Paar aus module und moduleResolution werden markiert, bevor tsc sich beschwert.
Zuletzt aktualisiert:
tsconfig.json
Was jede Option bewirkt
Anleitung: tsconfig.json-Generator
- Wähle eine Vorlage, die zu deinem Projekt passt: Node.js ESM oder CommonJS, eine React-+-Vite-App, eine veröffentlichbare Bibliothek oder das strikteste Setup.
- Passe Sprache und Module an: das JavaScript-Ziel, eingebaute Libs, Modulformat und Auflösungsstrategie sowie den JSX-Modus.
- Wähle Typprüfungen und Ausgabeoptionen wie strict, noUncheckedIndexedAccess, outDir, Deklarationsdateien und Source Maps.
- Füge Pfad-Aliasse hinzu wie
@/* ./src/*und lege include/exclude-Ordner fest. - Lies die Hinweise und Erklärungen, kopiere oder lade dann die tsconfig.json ins Stammverzeichnis deines Projekts und führe
npx tsc --noEmitaus.
module und moduleResolution richtig kombinieren
Die meisten verwirrenden tsconfig-Fehler kommen von einem Paar aus module und moduleResolution, das nicht dazu passt, wie der Code tatsächlich läuft. Diese Kombinationen empfiehlt TypeScript:
| Projekt | module | moduleResolution | Typische Extras |
|---|---|---|---|
| Node.js führt das kompilierte JS aus (ESM oder CJS) | NodeNext | NodeNext (oder weglassen) | outDir, types: ["node"], .js-Endungen in Imports |
| App, gebaut mit Vite, webpack, esbuild, Parcel | ESNext oder Preserve | Bundler | noEmit, isolatedModules, jsx |
| Älteres reines CommonJS-Node.js-Projekt | CommonJS | Node10 | esModuleInterop |
| Auf npm veröffentlichte Bibliothek | NodeNext | NodeNext | declaration, declarationMap, sourceMap |
| Code, der von tsx, ts-node, Bun oder Deno ausgeführt wird | Preserve oder ESNext | Bundler | noEmit, allowImportingTsExtensions |
Ein target wählen
| target | Wichtige Syntax, die unverändert bleibt | Geeignet für |
|---|---|---|
ES2017 | async / await | Ältere Browser und Node 8+ |
ES2020 | Optional Chaining ?., Nullish ??, BigInt | Evergreen-Browser, Node 14+ |
ES2022 | Klassenfelder, #private, Top-Level-await, .at() | Node 16.11+ / 18+, aktuelle Browser |
ES2023+ | Array-findLast, toSorted und ähnliche APIs (über lib) | Node 20+ und neuere Browser |
ESNext | Alles, was die TypeScript-Version unterstützt | Code, den ein anderes Tool später transpiliert |
Denk daran, dass target nur die Syntax ändert. Laufzeit-APIs wie Array.prototype.at werden nicht nachgerüstet (Polyfill); lib erklärt nur, dass sie existieren.
Tipps für eine gesunde Konfiguration
- Starte strikt.
strictvon Anfang an zu aktivieren kostet wenig; es nachträglich in einer großen bestehenden Codebasis einzuschalten, kann Hunderte Fehler zutage fördern. - Nutze extends für gemeinsame Einstellungen. Monorepos haben oft eine
tsconfig.base.jsonund lassen jedes Paket"extends": "../../tsconfig.base.json"verwenden. - Prüfe, was enthalten ist.
npx tsc --listFilesOnlygibt jede Datei im Programm aus, undnpx tsc --showConfigzeigt die endgültig zusammengeführten Optionen. - Trenne Build und Typprüfung. Lass in gebündelten Apps den Bundler das JavaScript erzeugen und führe
tsc --noEmitin der CI aus, um Typfehler zu finden.
Häufige Fragen
Was ist tsconfig.json?
tsconfig.json ist die Konfigurationsdatei eines TypeScript-Projekts. Ihre compilerOptions sagen dem TypeScript-Compiler (tsc) und deinem Editor, welche JavaScript-Version ausgegeben wird, wie Module aufgelöst werden und welche Typprüfungen laufen, während include und exclude festlegen, welche Dateien zum Projekt gehören.
Welche moduleResolution sollte ich verwenden?
Nutze NodeNext (mit module NodeNext) für Code, den Node.js direkt ausführt, denn es folgt den echten Regeln von Node inklusive package.json-exports und vorgeschriebener .js-Endungen. Nutze Bundler (mit module ESNext oder Preserve) für Apps, die mit Vite, webpack, esbuild oder ähnlichen Tools gebaut werden. Node10 ist der alte CommonJS-Algorithmus und ignoriert exports-Maps.
Was aktiviert strict: true?
strict schaltet eine ganze Familie von Prüfungen ein: strictNullChecks, noImplicitAny, strictFunctionTypes, strictBindCallApply, strictPropertyInitialization, noImplicitThis, useUnknownInCatchVariables und alwaysStrict. Neue strict-Optionen aus späteren TypeScript-Versionen sind automatisch enthalten. Zusätzliche Prüfungen wie noUncheckedIndexedAccess gehören nicht zu strict und müssen separat aktiviert werden.
Warum funktionieren meine Pfad-Aliasse im Editor, aber nicht zur Laufzeit?
paths sagt TypeScript nur, wo die Typen zu finden sind; tsc schreibt Importpfade im erzeugten JavaScript nicht um. Konfiguriere denselben Alias in deinem Bundler (zum Beispiel Vite resolve.alias), nutze package.json-imports mit #-Aliassen oder einen Laufzeit-Helfer wie tsconfig-paths.
Brauche ich baseUrl für paths?
Nein. Seit TypeScript 4.1 kann paths ohne baseUrl verwendet werden und wird relativ zur tsconfig.json-Datei aufgelöst. baseUrl macht außerdem jeden nackten Import aus diesem Ordner auflösbar, was Fehler verbergen kann, daher lassen neue Projekte es meist weg.
Warum verlangt TypeScript .js-Endungen in meinen Imports?
Mit module und moduleResolution auf Node16 oder NodeNext folgen ES-Moduldateien den Node.js-Regeln, die vollständige relative Pfade verlangen. Du schreibst import './util.js', obwohl die Quelldatei util.ts heißt, weil genau diese Datei nach dem Kompilieren existieren wird.
Darf eine tsconfig.json Kommentare enthalten?
Ja. TypeScript liest tsconfig.json als JSON mit Kommentaren, daher werden //- und /* */-Kommentare sowie abschließende Kommas akzeptiert. Manche anderen Tools, die die Datei als striktes JSON lesen, akzeptieren eventuell keine Kommentare; schalte die Option Kommentare aus, wenn du reines JSON brauchst.
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.