Startseite › Entwickler-Tools › tsconfig.json-Generator

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:

Sprache & Module
Typprüfung
Interop & JavaScript
Ausgabe
Pfade & Dateien

tsconfig.json

    Was jede Option bewirkt
    Anzeige
    Anzeige

    Anleitung: tsconfig.json-Generator

    1. 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.
    2. Passe Sprache und Module an: das JavaScript-Ziel, eingebaute Libs, Modulformat und Auflösungsstrategie sowie den JSX-Modus.
    3. Wähle Typprüfungen und Ausgabeoptionen wie strict, noUncheckedIndexedAccess, outDir, Deklarationsdateien und Source Maps.
    4. Füge Pfad-Aliasse hinzu wie @/* ./src/* und lege include/exclude-Ordner fest.
    5. Lies die Hinweise und Erklärungen, kopiere oder lade dann die tsconfig.json ins Stammverzeichnis deines Projekts und führe npx tsc --noEmit aus.

    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:

    ProjektmodulemoduleResolutionTypische Extras
    Node.js führt das kompilierte JS aus (ESM oder CJS)NodeNextNodeNext (oder weglassen)outDir, types: ["node"], .js-Endungen in Imports
    App, gebaut mit Vite, webpack, esbuild, ParcelESNext oder PreserveBundlernoEmit, isolatedModules, jsx
    Älteres reines CommonJS-Node.js-ProjektCommonJSNode10esModuleInterop
    Auf npm veröffentlichte BibliothekNodeNextNodeNextdeclaration, declarationMap, sourceMap
    Code, der von tsx, ts-node, Bun oder Deno ausgeführt wirdPreserve oder ESNextBundlernoEmit, allowImportingTsExtensions

    Ein target wählen

    targetWichtige Syntax, die unverändert bleibtGeeignet für
    ES2017async / awaitÄltere Browser und Node 8+
    ES2020Optional Chaining ?., Nullish ??, BigIntEvergreen-Browser, Node 14+
    ES2022Klassenfelder, #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
    ESNextAlles, was die TypeScript-Version unterstütztCode, 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. strict von 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.json und lassen jedes Paket "extends": "../../tsconfig.base.json" verwenden.
    • Prüfe, was enthalten ist. npx tsc --listFilesOnly gibt jede Datei im Programm aus, und npx tsc --showConfig zeigt 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 --noEmit in 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.

    Ähnliche Tools

    Alle Code-Generatoren & Builder ansehen →