Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Migration af kode og frameworks

Lektion 10 af 20 Opdateret 29. juli 2026 Udvikler
På denne side
  1. Migrér sikkert med Codex
  2. Framework-migrationer
  3. Migration af hovedversioner
  4. Database-migrationer
  5. Biblioteksmigrationer
  6. Strategi for progressiv migration
  7. Vigtige pointer

Migrér sikkert med Codex

Migration af frameworks, biblioteker og hovedversioner er blandt de risikofyldte opgaver inden for udvikling: De påvirker hele projektet på én gang, kan ikke udføres halvhjertet, og de falger altid på det værst tænkelige tidspunkt i kvartalet. Codex reducerer en migration, der normalt tager flere dage, til få timer ved systematisk at håndtere API-ændringer og inkompatibiliteter – præcis der, hvor menneskelig opmærksomhed begynder at svigte omkring fil nummer tredive.

Framework-migrationer

At skifte framework er det mest ambitiøse scenarie og ofte det, der ender som et opgivet projekt i en to år gammel ticket.

"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."

Oversigten øverst i prompten er ikke pynt: Den garanterer, at ingen middleware bliver glemt. Codex fortsætter derefter trin for trin – analyserer den eksisterende Express-konfiguration, opretter den tilsvarende Fastify-konfiguration, migrerer hver rute med tilpasset syntaks, udskifter middleware med deres modstykker, opdaterer tests og verificerer, at alt består. Instruktionen „rute for rute” giver dig som bonus en læsbar diff, hvor hver rute kan gennemgås isoleret uden at skulle scrolle gennem de andre fjorten.

Migration af hovedversioner

Selvom opgraderinger af hovedversioner er mere almindelige, er de ikke mindre tricky, fordi ødelæggende ændringer er spredt i stedet for koncentreret.

"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 bruger de officielle migrationsnoter i sin kontekst og anvender ændringerne systematisk. Tag dig tid til selv at skrive disse nøglepunkter: De guider søgningen under udførelsen og fungerer som din tjekliste under gennemgangen, hvilket fordobler værdien.

Database-migrationer

Ved schema-ændringer ligger udfordringen aldrig i selve SQL-migrationen, men i al den applikationskode, der afhænger af den.

"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 håndterer alle tre lag i én enkelt opgave: Prisma-schemaet, SQL-migrationen og alle referencer i applikationen. En simpel omdøbning fra email til primaryEmail påvirker typisk omkring tredive filer, herunder nogle, som en naiv tekstsøgning ikke finder – et dynamisk opbygget felt, en serialiseringsnøgle, en sorteringsmapping.

Biblioteksmigrationer

At erstatte ét bibliotek med et andet kræver, at du eksplicit navngiver, hvad der skal forblive uændret.

"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"

Punktet om tidszoner er det, der redder datamigrationer: To biblioteker kan producere identisk output på din maskine og afvige med en time på en UTC-server. For denne type arbejde viser gevinstens omfang sig i tabellen nedenfor.

Almindelig migrationManuel varighedVarighed med Codex
JavaScript til TypeScript1-2 uger2-4 timer
REST til GraphQL2-3 uger1-2 dage
Webpack til Vite2-5 dage2-4 timer
moment.js til date-fns1-3 dage30 minutter - 2 timer

Strategi for progressiv migration

Disse varigheder forudsætter en enkelt gennemførelse, hvilket kun er rimeligt for beskedne projekter. I alle andre tilfælde skal du opdele opgaven. En bevidst afgrænset første fase etablerer de konventioner, som efterfølgende faser vil følge:

"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."

Når denne fase er valideret og mergede, bygger den næste fase eksplicit videre på den:

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

Fordelen er dobbelt. Risikoen holdes begrænset, da en mislykket fase kan rulles tilbage uden at annullere resten af arbejdet. Og hver fase producerer en pull request, som et menneske faktisk kan gennemgå – et afgørende kriterium, fordi en migration leveret som en enkelt diff på seks hundrede filer ikke bliver gennemgået; den bliver godkendt af udmattelse, hvilket annullerer det meste af den forventede gevinst.

Vigtige pointer

  • Migrationer er de opgaver, hvor Codex leverer den største produktivitetsgevinst
  • Angiv de nøglepunkter, der er specifikke for dit projekt, i dine instruktioner
  • Arbejd i progressive faser ved store migrationer
  • Codex opdaterer kode, tests og afhængigheder i én enkelt opgave
  • Verificér altid med et fuldt build og tests efter en migration