Pfad-Mapping und Modulauflösung
Konfigurieren Sie Pfad-Aliase mit baseUrl/paths, verstehen Sie, wie TS Module auflöst, und vermeiden Sie häufige Fallstricke.
Pfad-Mapping und Modulauflösung ist eine kostenlose TypeScript Academy-Lektion auf CoddyKit. Dies ist Lektion 3 von 3. 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 3 Lektionen.
Einführung
Ziel: Ersetzen Sie lange relative Importe durch Pfad-Aliase und verstehen Sie die Regeln der Modulauflösung von TypeScript, damit Importe übersichtlich bleiben.
tsconfig-Pfade
Legen Sie baseUrl fest (Projektstamm für nicht-relative Importe) und ordnen Sie Aliase in paths zu. Schlüssel können *-Globs verwenden.
// file: tsconfig.json (excerpt)
{
"compilerOptions": {
"baseUrl": "./src",
"paths": {
"@utils/*": ["utils/*"],
"@components/*": ["components/*"]
}
}
}Alias verwenden
Importieren Sie mit dem Alias genau so, wie er deklariert wurde (z. B. @utils/date). TypeScript löst ihn zum zugeordneten Pfad in src/ auf.
// file: src/app.ts
import { formatDate } from "@utils/date";
import Button from "@components/Button";
console.log(formatDate(new Date()));
const btn = new Button();Auflösungsstrategie
Die Auflösung hängt von module ab (Node, NodeNext, Bundler). TS prüft Dateierweiterungen, package.json-Einträge exports/types und greift anschließend auf node_modules zurück.
// Resolution order sketch (NodeNext/Node):
// 1) Exact file: .ts/.tsx/.d.ts/.js
// 2) Index files: index.ts / index.js
// 3) package.json exports / types
// 4) paths & baseUrl fallbacks
// 5) node_modules lookup (upwards)
export const note = "Resolution depends on module setting (Node, NodeNext, Bundler).";Abstimmung mit dem Bundler
Wichtig: TS kennt Aliase für die Typprüfung, aber Ihr Bundler/Laufzeitsystem muss sie ebenfalls abbilden (z. B. Vite/Webpack/tsconfig-paths für ts-node).
// Example: vite.config.ts (alias for runtime)
import { defineConfig } from "vite";
import path from "path";
export default defineConfig({
resolve: {
alias: {
"@utils": path.resolve(__dirname, "src/utils"),
"@components": path.resolve(__dirname, "src/components")
}
}
});Tipps und Stolperfallen
Tipps:
- Halten Sie baseUrl stabil (z. B. src/).
- Spiegeln Sie Aliase im Bundler/Laufzeitsystem.
- Vermeiden Sie tiefe ../..-Ketten und bevorzugen Sie kurze Aliase.
Prüfung zu Pfad-Aliasen
Schnellprüfung: Welche tsconfig-Optionen aktivieren Pfad-Aliase wie @utils/*?
Zusammenfassung
Zusammenfassung: Konfigurieren Sie baseUrl und paths für Aliase, lernen Sie die Auflösungsreihenfolge von TS kennen und stimmen Sie Bundler/Laufzeitsystem darauf ab, um fehlerhafte Importe zu vermeiden.
Häufig gestellte Fragen
Ist die Lektion „Pfad-Mapping und Modulauflösung“ kostenlos?
Ja — der vollständige Text von „Pfad-Mapping und Modulauflösung“ 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 3 Lektionen.
Was lerne ich in „Pfad-Mapping und Modulauflösung“?
Konfigurieren Sie Pfad-Aliase mit baseUrl/paths, verstehen Sie, wie TS Module auflöst, und vermeiden Sie häufige Fallstricke. 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 3.
Wie lange dauert die Lektion „Pfad-Mapping und Modulauflösung“?
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
- ES-Module (benannt vs. Standard), Re-Exports
- Ambient-Deklarationen (.d.ts) und Typisierungen von Drittanbietern
- Pfad-Mapping und Modulauflösung