Refaktorering och förbättring av befintlig kod
På denna sida
Omvandling av äldre kod till modern kod
Refaktorering är en av de mest tidskrävande uppgifterna inom utveckling, och sällan den mest belönade: ingen gratulerar dig för att du delar upp en fil på 800 rader. Det är precis därför den ackumuleras, sprint efter sprint, tills den blir den verkliga orsaken till att ditt tempo sjunker. Codex reducerar timmar av manuellt arbete till minuter samtidigt som befintligt beteende bevaras – det enda som verkligen spelar roll vid en refaktorering.
Strukturell refaktorering
Det vanligaste fallet är den allomfattande filen som ingen vågar röra eftersom den importeras överallt.
"Refactor src/utils/helpers.ts: this file is 800 lines long.
Split it into thematic modules in src/utils/ (string.ts,
date.ts, validation.ts, formatting.ts). Update all imports
across the project."
Codex hanterar denna typ av uppgifter exceptionellt bra: det identifierar funktioner, grupperar dem efter tema, skapar de nya filerna och uppdaterar sedan varje import i hela projektet. Det sista steget är oftast det som avskräcker från manuell refaktorering – fyrtio filer att fixa, en missad import, och bygget kraschar vid värsta möjliga tidpunkt. Resultatet är dessutom objektivt verifierbart: om testen gick igenom tidigare och fortfarande gör det, så är uppdelningen korrekt.
Modernisering av kod
Det andra stora fallet är uppdatering till moderna mönster, där transformationen är mekanisk men så repetitiv att den ständigt skjuts upp i backlogen.
"Migrate all callbacks in src/lib/database.ts to
async/await. Preserve existing error handling."
Utgångspunkten är JavaScript baserat på callbacks med sin kaskadartade felhantering:
function getUser(id, callback) {
db.query("SELECT * FROM users WHERE id = ?", [id],
(err, rows) => {
if (err) return callback(err);
callback(null, rows[0]);
});
}
Här är vad Codex producerar:
async function getUser(id: string): Promise<User> {
const rows = await db.query(
"SELECT * FROM users WHERE id = ?",
[id]
);
return rows[0];
}
Tre saker hände i ett enda steg: TypeScript-typer dök upp, callbacks ersattes av async/await och felhanteringen förenklades eftersom undantag nu propagerar naturligt. Affärslogiken förblir identisk – och det är exakt det du verifierar vid granskning, inte resultatets elegans.
Förbättring av kvalitet
Du kan också rikta in dig på en specifik kvalitetsdimension snarare än en syntaktisk transformation, förutsatt att du räknar upp kraven.
"In src/api/, improve error handling:
- Replace generic try/catch blocks with typed errors
- Add appropriate HTTP error codes
- Add logging with request context
- Ensure Prisma errors are mapped correctly"
Formulerat på detta sätt blir begäran verifierbar punkt för punkt under granskningen. En fristående uppmaning att “förbättra felhanteringen” skulle producera något som verkar rimligt men är oanvändbart, eftersom varken du eller agenten skulle veta när målet var nått.
Refaktorering baserad på mönster
Den mest kraftfulla varianten innebär att du pekar ut en redan compliant fil och begär generalisering.
"All React components in src/components/ that use
useState for forms must migrate to react-hook-form.
Apply the same pattern as src/components/LoginForm.tsx,
which is already migrated."
Codex läser referenskomponenten, extraherar mönstret och tillämpar det på målkomponenterna samtidigt som det hanterar specialfall – anpassad validering, sidoeffekter – istället för att göra en blind ersättning. Den praktiska implikationen är intressant: den första komponenten, den du migrerar själv, betalar för alla andra. Lägg vård på denna modellfil; den är värd en specifikation.
Verifiering av refaktoreringen
Codex kör tester efter varje refaktorering, men en refaktorering som klarar testen är inte nödvändigtvis levereringsklar. Fyra kontroller utgör minimum, och var och en adresserar en annan risk.
| Kontroll | Kommando | Vad det verifierar |
|---|---|---|
| Enhetstester | npm run test | Beteendet är bevarat |
| Typer | npx tsc --noEmit | Inga typfel |
| Linting | npm run lint | Konventioner följs |
| Bygge | npm run build | Produktionsredo |
Det typiska fallet som motiverar denna lista: att flytta filer låter testen förbli gröna eftersom de importerar från en barrel-fil, men kraschar produktionsbygget på en cirkulär import som inget annat avslöjar. Lägg till dessa fyra kommandon i din fil AGENTS.md, så kommer Codex att köra dem efter varje ändring utan att du behöver tänka på det eller påminna den.
Viktiga punkter
- Refaktorering är den uppgift där Codex levererar störst tidsbesparing
- Referera till en modellfil för att styra refaktoreringens mönster
- Codex uppdaterar importer och referenser i hela projektet
- Verifiera alltid med tester, typkontroll och bygge efter refaktorering
- Dokumentera verifieringskommandon i AGENTS.md