0Pricing
TypeScript Academy · Lektion

skipLibCheck und isolierte Deklarationen

Verwenden Sie Compiler-Flags, um große Projekte zu beschleunigen.

skipLibCheck und isolierte Deklarationen ist eine kostenlose TypeScript Academy-Lektion auf CoddyKit. Dies ist Lektion 3 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des TypeScript Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der TypeScript Academy-Kurs umfasst insgesamt 4 Lektionen.

Was ist skipLibCheck?

skipLibCheck: true weist TypeScript an, die Typprüfung aller .d.ts-Deklarationsdateien zu überspringen. Dadurch wird Sicherheit zugunsten von Geschwindigkeit aufgegeben.

// tsconfig.json
{
  "compilerOptions": {
    "skipLibCheck": true
  }
}

Wann Sie skipLibCheck verwenden sollten

Verwenden Sie es, wenn die .d.ts-Dateien von Drittanbietern Fehler enthalten, die Sie nicht beheben können, oder in großen Projekten, in denen die Typprüfung von Bibliotheken den größten Teil der Kompilierzeit beansprucht.

// Common scenario: two libraries ship conflicting .d.ts
// skipLibCheck: true silences those errors so you can focus on your code

Risiken von skipLibCheck

Möglicherweise übersehen Sie echte Typfehler in Deklarationsdateien, die Fehler an Schnittstellen erkennen würden. Verwenden Sie diese Option bewusst und aktivieren Sie die Prüfung regelmäßig erneut, um Regressionen zu erkennen.

// Risk: incorrect .d.ts in a library goes undetected
// Mitigation: enable skipLibCheck only for known-safe packages

skipDefaultLibCheck

skipDefaultLibCheck: true ist eine gezieltere Option. Sie überspringt nur die integrierten TypeScript-Bibliotheksdeklarationen (lib.d.ts), nicht die Deklarationen von Drittanbietern.

{
  "compilerOptions": {
    "skipDefaultLibCheck": true
    // Third-party .d.ts files still checked
  }
}

Was sind isolierte Deklarationen?

isolatedDeclarations: true (TS 5.5+) erfordert für jedes exportierte Symbol eine explizite Typannotation. Dadurch kann TypeScript Deklarationen ohne vollständige Typinferenz erzeugen.

// tsconfig.json
{
  "compilerOptions": {
    "isolatedDeclarations": true
  }
}

Warum isolatedDeclarations die Verarbeitung beschleunigt

Mit isolatedDeclarations können die Deklarationen jeder Datei unabhängig erzeugt werden, ohne den restlichen Teil des Programms zu analysieren. Build-Tools können diese Arbeit pro Datei parallelisieren.

// Without isolatedDeclarations:
// File A's .d.ts requires type-checking File B's return type first.
// With isolatedDeclarations:
// Each file's .d.ts generated from its explicit annotations alone.

Fehler: Rückgabetypannotation fehlt

Wenn isolatedDeclarations aktiviert ist, verursachen exportierte Funktionen ohne Rückgabetypannotation einen Kompilierfehler.

// Error with isolatedDeclarations: true
export function getUser(id: string) { return fetchUser(id); }

// Fix: add explicit return type
export function getUser(id: string): Promise<User> { return fetchUser(id); }

isolatedDeclarations und DTS-Bundler

Tools wie dts-buddy und oxc nutzen isolatedDeclarations, um Deklarations-Bundles deutlich schneller als tsc zu erzeugen.

# oxc with isolatedDeclarations for fast .d.ts generation
npx oxc-transform ./src --declarations

Beide Optionen kombinieren

Für maximale Leistung in großen Monorepos: skipLibCheck: true, um Deklarationsfehler von Drittanbietern zu ignorieren, und isolatedDeclarations: true für die parallele Erzeugung von Deklarationen.

{
  "compilerOptions": {
    "skipLibCheck": true,
    "isolatedDeclarations": true
  }
}

Migrationspfad

Wenn Sie isolatedDeclarations in einer bestehenden Codebasis aktivieren, müssen Sie jeder exportierten Funktion eine Rückgabetypannotation hinzufügen. Verwenden Sie ts-migrate oder die automatische Fehlerbehebung von ESLint, um dies in großem Umfang zu erledigen.

# ESLint rule to auto-add return types:
# @typescript-eslint/explicit-function-return-type

Rückblick: skipLibCheck und isolierte Deklarationen

skipLibCheck überspringt die Typprüfung von .d.ts-Dateien und erhöht dadurch die Geschwindigkeit. isolatedDeclarations erfordert explizite Annotationen, um die parallele Erzeugung von Deklarationen pro Datei zu ermöglichen – eine wichtige Voraussetzung für schnellere Tools.

Kurzer Test

Was erfordert isolatedDeclarations: true?

Das haben Sie gelernt

skipLibCheck erhöht die Geschwindigkeit, indem es Deklarationsfehler von Drittanbietern ignoriert. isolatedDeclarations erfordert explizite Rückgabetypen für Exporte und ermöglicht dadurch die parallele Erzeugung von Deklarationen pro Datei sowie schnellere Tooling-Pipelines.

Häufig gestellte Fragen

Ist die Lektion „skipLibCheck und isolierte Deklarationen“ kostenlos?

Ja — der vollständige Text von „skipLibCheck und isolierte Deklarationen“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des TypeScript Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der TypeScript Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „skipLibCheck und isolierte Deklarationen“?

Verwenden Sie Compiler-Flags, um große Projekte zu beschleunigen. Du übst TypeScript Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um TypeScript Academy zu starten?

Keine Vorkenntnisse erforderlich. TypeScript Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 3 von 4.

Wie lange dauert die Lektion „skipLibCheck und isolierte Deklarationen“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser TypeScript Academy-Lektion Code schreiben und ausführen?

Ja. Jede TypeScript Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

  1. Langsame TypeScript-Kompilierung profilieren
  2. Aufwendige Typoperationen vermeiden
  3. skipLibCheck und isolierte Deklarationen
  4. Typprüfung in CI: Strategien und Werkzeuge
← Zurück zu TypeScript Academy