Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Olemasoleva koodi refaktoriseerimine ja täiustamine

Õppetund 6 / 20 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Pärandkoodi muutmine moodsaks koodiks
  2. Struktuurne refaktoriseerimine
  3. Koodi moderniseerimine
  4. Kvaliteedi parandamine
  5. Mustritel põhinev refaktoriseerimine
  6. Refaktoriseerimise kontrollimine
  7. Peamised punktid

Pärandkoodi muutmine moodsaks koodiks

Refaktoriseerimine on üks arenduse aeganõudvamaid ülesandeid ja harva kõige tasustatum: keegi ei õnnitle sind 800-realise faili tükkideks lõikamise eest. Just seetõttu see kuhjub, sprint sprindi järel, kuni sellest saab sinu töö aeglustumise tegelik põhjus. Codex vähendab tundide kaupa käsitsi tehtavat tööd minutiteni, säilitades samal ajal olemasoleva käitumise – see on ainus asi, mis refaktoriseerimisel tõeliselt loeb.

Struktuurne refaktoriseerimine

Kõige levinum juhtum on nn „kõikehõlmav“ fail, mida keegi ei julge puutuda, sest seda imporditakse kõikjal.

"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 saab selliste ülesannetega erakordselt hästi hakkama: ta tuvastab funktsioonid, rühmitab need teemade kaupa, loob uued failid ja uuendab seejärel kõik impordid kogu projektis. Just viimane samm on see, mis tavaliselt käsitsi refaktoriseerimisest heidutab – nelikümmend faili parandada, üks ununenud import ja build jookseb kokku kõige ebasobivamal hetkel. Tulemus on objektiivselt kontrollitav: kui testid läbisid enne ja läbivad ka nüüd, on jaotus õige.

Koodi moderniseerimine

Teine suur juhtum on uuendamine moodsatele mustritele, kus teisendus on mehaaniline, kuid nii korduv, et seda lükatakse järjekindlalt tagavarasse.

"Migrate all callbacks in src/lib/database.ts to 
async/await. Preserve existing error handling."

Lähtepunktiks on callback-põhine JavaScript koos oma kaskaadse veakäitlusega:

function getUser(id, callback) {
  db.query("SELECT * FROM users WHERE id = ?", [id], 
    (err, rows) => {
      if (err) return callback(err);
      callback(null, rows[0]);
    });
}

Siin on see, mida Codex toodab:

async function getUser(id: string): Promise<User> {
  const rows = await db.query(
    "SELECT * FROM users WHERE id = ?", 
    [id]
  );
  return rows[0];
}

Ühe korraga juhtus kolm asja: ilmusid TypeScripti tüübid, callbackud asendusid async/await-ga ja veakäitlus lihtsustus, kuna erandid levivad nüüd loomulikult. Ärilogiika jääb identseks – ja just seda sa ülevaatusel kontrollid, mitte tulemuse elegantsust.

Kvaliteedi parandamine

Saad sihtida ka konkreetset kvaliteedimõõdet, mitte süntaktilist teisendust, eeldusel, et loetled nõuded üles.

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

Nii sõnastatuna muutub taotlus ülevaatuse käigus punkt-punkti haaval kontrollitavaks. Eraldiseisev „paranda veakäitlust“ vihje tooks kaasa midagi usutavat, kuid kasutamatut, sest ei sina ega agent ei teaks, millal eesmärk on saavutatud.

Mustritel põhinev refaktoriseerimine

Võimsaim variant seisneb juba vastava faili määramises ja üldistamise taotlemises.

"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 loeb võrdluskomponendi, eraldab mustri ja rakendab seda sihtkomponentidele, hallates samal ajal erijuhte – kohandatud valideerimine, kõrvalmõjud – selle asemel, et teha pimesi asendamist. Praktiline järeldus on huvitav: esimene komponent, mille sa ise migreerid, tasub ära kõik ülejäänud. Investeeri hoolt sellesse mudelfaili; see on väärt spetsifikatsiooni.

Refaktoriseerimise kontrollimine

Codex käivitab testid pärast iga refaktoriseerimist, kuid testid läbinud refaktoriseerimine ei ole tingimata valmis kasutuselevõtuks. Neli kontrolli moodustavad miinimumi ja igaüks neist käsitleb erinevat riski.

KontrollKäskMida see kontrollib
Ühiktestidnpm run testKäitumine on säilinud
Tüübidnpx tsc --noEmitTüügivigu pole
Lintiminenpm run lintKokkulepped on täidetud
Buildnpm run buildValmis tootmiseks

Tüüpiline juhtum, mis seda nimekirja õigustab: failide liigutamine jätab testid roheliseks, kuna need impordivad tünnifailist, kuid rikub tootmisbuildi tsüklilise impordi tõttu, mida miski muu ei paljasta. Lisa need neli käsku oma AGENTS.md faili ja Codex käivitab need pärast iga muudatust, ilma et sa peaksid sellele mõtlema või teda meenutama.

Peamised punktid

  • Refaktoriseerimine on ülesanne, kus Codex pakub suurimat ajasäästu
  • Viita mudelfailile, et juhtida refaktoriseerimise mustrit
  • Codex uuendab importe ja viiteid kogu projektis
  • Kontrolli alati pärast refaktoriseerimist testide, tüübikontrolli ja buildiga
  • Dokumenteeri kontrollkäsud failis AGENTS.md