Refaktoriranje in izboljševanje obstoječe kode
Na tej strani
Preoblikovanje stare kode v sodobno kodo
Refaktoriranje je ena najbolj časovno zahtevnih nalog v razvoju in redko najbolj nagrajena: nihče ti ne čestita, ker si razdelil datoteko z 800 vrsticami. Prav zato se dolgovi kopičijo iz sprinta v sprint, dokler ne postanejo pravi vzrok za upočasnitev. Codex skrajša ure ročnega dela na minute, hkrati pa ohrani obstoječe obnašanje – kar je pri refaktoriranju edino, kar res šteje.
Strukturno refaktoriranje
Najpogostejši primer je datoteka „vse-v-enem”, ki se je nihče ne upa dotakniti, ker je uvožena povsod.
"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 izjemno dobro obvlada to družino nalog: prepozna funkcije, jih združi po temah, ustvari nove datoteke in nato posodobi vse uvoze v projektu. Prav zadnji korak je tisti, ki običajno odvrne od ročnega refaktoriranja – popraviti je treba štirideset datotek, en sam pozabljen uvoz in gradnja se poruši v najslabšem možnem trenutku. Rezultat je objektivno preverljiv: če so testi delovali prej in delujejo še vedno, je razdelitev pravilna.
Posodabljanje kode
Drugi glavni primer je prehod na sodobne vzorce, kjer je preoblikovanje mehansko, a tako ponavljajoče se, da ga nenehno odlagamo na seznam čakajočih nalog.
"Migrate all callbacks in src/lib/database.ts to
async/await. Preserve existing error handling."
Izhodišče je JavaScript, ki temelji na povratnih klicih s kaskadnim obravnavanjem napak:
function getUser(id, callback) {
db.query("SELECT * FROM users WHERE id = ?", [id],
(err, rows) => {
if (err) return callback(err);
callback(null, rows[0]);
});
}
To je rezultat, ki ga proizvede Codex:
async function getUser(id: string): Promise<User> {
const rows = await db.query(
"SELECT * FROM users WHERE id = ?",
[id]
);
return rows[0];
}
V enem samem koraku so se zgodile tri stvari: pojavile so se vrste TypeScript, povratni klici so umaknili async/await, obravnava napak pa se je poenostavila, saj se izjeme zdaj naravno širijo naprej. Poslovna logika ostaja identična – in prav to preveriš pri pregledu, ne elegance rezultata.
Izboljševanje kakovosti
Ciljaš lahko tudi na specifično razsežnost kakovosti namesto na sintaktično preoblikovanje, pod pogojem, da našteješ zahteve.
"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"
Tako oblikovan poziv postane med pregledom točka za točko preverljiv. Samostojen poziv „izboljšaj obravnavo napak” bi proizvedel nekaj verjetnega, a neuporabnega, ker niti ti niti agent ne bi vedela, kdaj je cilj dosežen.
Refaktoriranje na podlagi vzorcev
Najmočnejša različica vključuje določitev že skladne datoteke in zahtevo po posplošitvi.
"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 prebere referenčno komponento, izvleče vzorec in ga uporabi za ciljne komponente, pri čemer obravnava robne primere – prilagojeno validacijo, stranske učinke – namesto da bi izvedel slepo zamenjavo. Praktična posledica je zanimiva: prva komponenta, ki jo migriraš sam, plača za vse ostale. V to modelno datoteko vloži skrb; vredna je specifikacije.
Preverjanje refaktoriranja
Codex po vsakem refaktoriranju zažene teste, vendar refaktoriranje, ki opravi teste, še ni nujno pripravljeno za izdajo. Štirje pregledi predstavljajo minimum in vsak naslavlja drugačno tveganje.
| Pregled | Ukaz | Kaj preverja |
|---|---|---|
| Enotni testi | npm run test | Ohranjeno obnašanje |
| Vrste | npx tsc --noEmit | Brez napak v vrstah |
| Lintanje | npm run lint | Upoštevanje konvencij |
| Gradnja | npm run build | Pripravljenost za produkcijo |
Tipičen primer, ki upravičuje ta seznam: premikanje datotek pusti teste zelene, ker uvažajo iz zbiralne datoteke, a poruši produkcijsko gradnjo zaradi krožnega uvoza, ki ga nič drugega ne razkrije. Te štiri ukaze dodaj v svojo datoteko AGENTS.md in Codex jih bo zagnal po vsaki spremembi, ne da bi moral ti na to misliti ali ga opominjati.
Ključne ugotovitve
- Refaktoriranje je naloga, pri kateri Codex prinaša največji prihranek časa
- Za usmerjanje vzorca refaktoriranja se sklicuj na modelno datoteko
- Codex posodobi uvoze in reference v celotnem projektu
- Po refaktoriranju vedno preveri s testi, preverjanjem vrst in gradnjo
- Ukaze za preverjanje dokumentiraj v AGENTS.md