Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Code- und Framework-Migrationen

Lektion 10 von 20 Aktualisiert am 29. Juli 2026 Entwickler
Auf dieser Seite
  1. Sichere Migrationen mit Codex
  2. Framework-Migrationen
  3. Migrationen großer Versionen
  4. Datenbank-Migrationen
  5. Bibliotheks-Migrationen
  6. Progressive Migrationsstrategie
  7. Kernaussagen

Sichere Migrationen mit Codex

Migrationen von Frameworks, Bibliotheken und großen Versionen zählen zu den risikoreichsten Aufgaben in der Entwicklung: Sie betreffen das gesamte Projekt auf einmal, können nicht halbfertig abgeschlossen werden und landen fast immer zum ungünstigsten Zeitpunkt im Quartal. Codex reduziert eine mehr tägige Migration auf wenige Stunden, indem er API-Änderungen und Inkompatibilitäten systematisch bearbeitet – genau der Bereich, in dem die menschliche Aufmerksamkeit oft gegen Datei dreißig nachlässt.

Framework-Migrationen

Der Wechsel des Frameworks ist das ambitionierteste Szenario und endet häufig als aufgegebenes Projekt in einem Ticket, das bereits zwei Jahre alt ist.

"Migrate the application from Express.js to Fastify. 
The project uses Express with:
- 15 routes in src/routes/
- JWT authentication middleware
- Morgan logging middleware
- CORS middleware
- Centralized error handling

Migrate route by route, preserving existing tests."

Die Inventarliste am Anfang des Prompts ist keine Dekoration: Sie garantiert, dass kein Middleware-Komponente übersehen wird. Codex arbeitet dann in der richtigen Reihenfolge fort – er analysiert die bestehende Express-Konfiguration, erstellt die äquivalente Fastify-Konfiguration, migriert jede Route mit angepasster Syntax, tauscht Middleware-Komponenten gegen ihre Äquivalente aus, aktualisiert die Tests und überprüft, ob alles funktioniert. Die Anweisung „Route für Route” liefert als Bonus eine lesbare Differenz, bei der jede Route isoliert überprüft werden kann, ohne durch die anderen vierzehn zu scrollen.

Migrationen großer Versionen

Häufiger sind große Versionserhöhungen, die nicht weniger knifflig sind, da sich die brechenden Änderungen verstreut statt konzentriert befinden.

"Migrate the project from React 18 to React 19.
Key points:
- Replace forwardRef with native ref props
- Migrate useContext usage to the new pattern
- Update TypeScript types (@types/react)
- Verify third-party library compatibility"

Codex stützt sich auf die offiziellen Migrationshinweise in seinem Kontext und wendet die Änderungen systematisch an. Nehmen Sie sich die Zeit, diese Schlüsselpunkte selbst zu formulieren: Sie leiten die Suche während der Ausführung und dienen als Ihre Checkliste während der Überprüfung, was den Wert verdoppelt.

Datenbank-Migrationen

Bei Schema-Änderungen liegt die Schwierigkeit nie in der SQL-Migration selbst, sondern in allem Anwendungscode, der davon abhängt.

"The User model needs restructuring:
- Separate address into an Address model (1-N relationship)
- Rename email to primaryEmail
- Add an optional phone field
- Create the Prisma migration
- Update all services and routes using User
- Update tests"

Codex bearbeitet alle drei Ebenen in einer einzigen Aufgabe: das Prisma-Schema, die SQL-Migration und alle Anwendungszugriffe. Eine einfache Umbenennung von email zu primaryEmail betrifft typischerweise etwa dreißig Dateien, darunter einige, die eine naive Textsuche nicht findet – ein dynamisch generiertes Feld, ein Serialisierungsschlüssel oder eine Sortierabbildung.

Bibliotheks-Migrationen

Der Ersatz einer Bibliothek durch eine andere erfordert die explizite Nennung dessen, was unverändert bleiben muss.

"Replace moment.js with date-fns throughout the project.
Ensure that:
- All date formats are preserved
- Duration calculations remain correct
- Date comparisons work properly
- Time zones are handled the same way"

Der Punkt zu den Zeitzonen ist das, was Datums-Migrationen rettet: Zwei Bibliotheken können auf Ihrem Gerät identische Ausgaben produzieren und sich auf einem UTC-Server um eine Stunde unterscheiden. Bei dieser Art von Arbeit zeigt sich der Umfang des Gewinns in der folgenden Tabelle.

Common MigrationManual DurationDuration with Codex
JavaScript to TypeScript1-2 weeks2-4 hours
REST to GraphQL2-3 weeks1-2 days
Webpack to Vite2-5 days2-4 hours
moment.js to date-fns1-3 days30 minutes - 2 hours

Progressive Migrationsstrategie

Diese Dauerannahmen gehen von einer Einzelausführung aus, was nur für bescheidene Projekte vernünftig ist. Überall sonst zerlegen Sie die Aufgabe. Eine bewusst abgegrenzte erste Phase etabliert die Konventionen, die die nachfolgenden Phasen einhalten werden:

"Phase 1: Migrate only src/lib/ from JavaScript to 
strict TypeScript. Do not touch React components or 
API routes. Add necessary types and fix typing errors."

Sobald diese Phase validiert und verschoben wurde, baut die nächste Phase explizit darauf auf:

"Phase 2: Migrate src/components/ from JavaScript to 
strict TypeScript. Use the same typing patterns as 
src/lib/ (phase 1 already migrated)."

Der Vorteil ist zweifach. Das Risiko bleibt begrenzt, da eine fehlgeschlagene Phase rückgängig gemacht werden kann, ohne den Rest der Arbeit zu beeinträchtigen. Und jede Phase erzeugt einen Pull-Request, den ein Mensch tatsächlich überprüfen kann – ein entscheidendes Kriterium, da eine Migration, die als einzelne Differenz von sechshundert Dateien geliefert wird, nicht überprüft wird; sie wird aus Erschöpfung genehmigt, was den meisten erwarteten Nutzen zunichtemacht.

Kernaussagen

  • Migrationen sind die Aufgaben, bei denen Codex die größte Produktivitätssteigerung liefert
  • Listen Sie die Schlüsselpunkte Ihres spezifischen Projekts in Ihren Anweisungen auf
  • Gehen Sie bei großen Migrationen in progressiven Phasen vor
  • Codex aktualisiert Code, Tests und Abhängigkeiten in einer einzigen Aufgabe
  • Überprüfen Sie nach einer Migration immer mit einem vollständigen Build und Tests