0Pricing
TypeScript Academy · Lektion

Strategie für die Konvertierung Datei für Datei

Benennen Sie .js schrittweise in .ts um, ohne etwas zu beschädigen.

Strategie für die Konvertierung Datei für Datei 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.

Der schrittweise Ansatz

Bei der dateiweisen Konvertierung wird jeweils eine .js-Datei in .ts umbenannt, während Sie auftretende Typfehler beheben. So bleibt das Projekt bei jedem Schritt kompilierbar.

# Step 1: rename
mv src/utils.js src/utils.ts
# Step 2: fix errors
npx tsc --noEmit
# Step 3: commit and repeat

Den richtigen Ausgangspunkt wählen

Beginnen Sie mit Leaf-Modulen – Dateien, die keine anderen Projektdateien importieren. Für diese müssen zunächst keine nachgelagerten TypeScript-Abhängigkeiten erfüllt werden.

# Find files with fewest imports from other project files:
grep -r "from './" src --include="*.js" | sort | uniq -c | sort -n
# Convert lowest-count files first

Fehler durch implizites any behandeln

Wenn eine JS-Datei in .ts umbenannt wird, führen nicht typisierte Parameter bei noImplicitAny: true zu Fehlern wegen implizitem any. Fügen Sie explizite Typen hinzu oder verwenden Sie vorübergehend any.

// Before: JS
function process(data) { return data.value; }

// After: TS (add annotation)
function process(data: { value: string }) { return data.value; }
// Or temporarily:
function process(data: any) { return data.value; }

Fehler vorübergehend unterdrücken

Verwenden Sie // @ts-ignore in schwer zu behebenden Zeilen und erfassen Sie diese als TODOs, damit sie nicht vergessen werden.

// TODO: type this properly in follow-up PR
// @ts-ignore
const result = complexLegacyFunction(x);

Importanweisungen aktualisieren

Wenn eine Datei zu .ts wird, müssen die Importe möglicherweise in den Dateien angepasst werden, die sie verwenden. TypeScript löst .ts-Dateien in Importpfaden automatisch ohne Dateiendung auf.

// No extension needed — TypeScript finds .ts
import { process } from "./utils";

Third-Party-require-Aufrufe konvertieren

Ersetzen Sie CommonJS-require-Aufrufe während der Konvertierung durch die ES-Modul-import-Syntax, damit sie zur TypeScript-Modulauflösung passt.

// Before: CommonJS
const fs = require("fs");
// After: ES module
import fs from "fs";

Schrittweise zum Strict-Modus

Aktivieren Sie Strict-Flags schrittweise pro Datei, indem Sie dateiweise // @ts-strict-ignore-Kommentare verwenden oder zu einer separaten tsconfig mit aktiviertem Strict-Modus migrieren.

// tsconfig.strict.json — points to converted files only
{
  "extends": "./tsconfig.json",
  "compilerOptions": { "strict": true },
  "include": ["src/converted/**/*"]
}

Verbleibende Dateien verfolgen

Führen Sie eine Checkliste oder verwenden Sie ein Skript, um die verbleibenden .js-Dateien zu zählen und den Migrationsfortschritt im Laufe der Zeit zu verfolgen.

find src -name "*.js" | wc -l   # remaining JS files
find src -name "*.ts" | wc -l   # converted TS files

Große PRs vermeiden

Konvertieren Sie eine Datei pro PR, damit die Reviews überschaubar bleiben. Große TypeScript-Migrationen lassen sich leichter prüfen und zurücknehmen, wenn sie auf einzelne Dateien begrenzt sind.

# Good: one file per PR
# Bad: 50 files renamed in one PR

Nach jeder Konvertierung Tests ausführen

Führen Sie nach jeder Dateikonvertierung die Testsuite aus, um Laufzeitregressionen zu erkennen, die die Typprüfung von TypeScript möglicherweise nicht findet.

npm test
# Ensure all tests pass after each .js → .ts rename

Zusammenfassung: Strategie Datei für Datei

Konvertieren Sie zuerst Leaf-Dateien, beheben oder unterdrücken Sie Fehler, halten Sie das Projekt bei jedem Schritt kompilierbar, verfolgen Sie die verbleibenden JS-Dateien und reichen Sie pro PR eine Datei ein, damit die Reviews überschaubar bleiben.

Schnelltest

Welche Dateien sollten Sie bei einer dateiweisen Migration zuerst zu TypeScript konvertieren?

Das haben Sie gelernt

Dateiweise Migration: Beginnen Sie mit Leaf-Modulen, benennen Sie sie in .ts um, beheben oder unterdrücken Sie Fehler, halten Sie das Projekt kompilierbar und verfolgen Sie den Fortschritt. Kleine Konvertierungen pro PR machen die Migration sicher und gut prüfbar.

Häufig gestellte Fragen

Ist die Lektion „Strategie für die Konvertierung Datei für Datei“ kostenlos?

Ja — der vollständige Text von „Strategie für die Konvertierung Datei für Datei“ 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 „Strategie für die Konvertierung Datei für Datei“?

Benennen Sie .js schrittweise in .ts um, ohne etwas zu beschädigen. 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 „Strategie für die Konvertierung Datei für Datei“?

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. Die Migration beginnen: allowJs und checkJs
  2. JSDoc-Typannotationen als Brücke
  3. Strategie für die Konvertierung Datei für Datei
  4. Umgang mit nicht typisierten Drittanbieterbibliotheken
← Zurück zu TypeScript Academy