Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Olemassa olevan koodin refaktorointi ja parantaminen

Oppitunti 6 / 20 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Vanhentuneen koodin muuntaminen moderniksi
  2. Rakenteellinen refaktorointi
  3. Koodin modernisointi
  4. Laadun parantaminen
  5. Mallipohjainen refaktorointi
  6. Refaktoroinnin varmentaminen
  7. Keskeiset asiat

Vanhentuneen koodin muuntaminen moderniksi

Refaktorointi on yksi kehitystyön aikaa vievimmistä tehtävistä, ja harvoin siitä saa kiitosta: kukaan ei onnittele sinua 800-rivisen tiedoston pilkkomisesta. Juuri siksi tekninen velka kasvaa sprintti sprintiltä, kunnes se muodostuu todelliseksi pullonkaulaksi. Codex kutistaa tuntikausia kestävän manuaalisen työn minuutteihin säilyttäen samalla olemassa olevan toiminnallisuuden – mikä onkin ainoa asia, jolla refaktoroinnissa on väliä.

Rakenteellinen refaktorointi

Yleisin tilanne on ns. “catch-all”-tiedosto, jota kukaan ei uskalla koskea, koska se on tuotu käyttöön kaikkialla.

"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 hoitaa tämän tyyppiset tehtävät erinomaisesti: se tunnistaa funktiot, ryhmittelee ne aihepiireittäin, luo uudet tiedostot ja päivittää tämän jälkeen kaikki projektin tuonnit (import). Juuri tämä viimeinen vaihe saa usein luopumaan manuaalisesta refaktoroinnista – neljäkymmentä tiedostoa korjattavana, yksi unohtunut tuonti, ja buildi hajoaa pahimpaan mahdolliseen hetkeen. Tulos on myös objektiivisesti varmennettavissa: jos testit menivät läpi ennen ja menevät edelleen, jako on onnistunut.

Koodin modernisointi

Toinen merkittävä tapaus on siirtyminen moderneihin malleihin, missä muunnos on mekaaninen mutta niin toistuva, että se siirtyy jatkuvasti backlogiin.

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

Lähtökohtana on callback-pohjainen JavaScript ketjutetun virheenkäsittelyn kera:

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

Tässä on se, mitä Codex tuottaa:

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

Yhdellä kertaa tapahtui kolme asiaa: TypeScript-tyypit ilmestyivät, callbackit väistyivät async/awaitin tieltä ja virheenkäsittely yksinkertaistui, sillä poikkeukset etenevät nyt luonnostaan. Liiketoimintalogiikka pysyy identtisenä – ja juuri tämä on se, mitä tarkistat katselmoinnissa, ei tuloksen eleganssia.

Laadun parantaminen

Voit kohdistaa pyynnön myös tiettyyn laadulliseen ulottuvuuteen syntaktisen muunnoksen sijaan, kunhan luettelet vaatimukset.

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

Näin muotoiltuna pyyntö on tarkistettavissa kohta kohdalta katselmoinnin aikana. Pelkkä “paranna virheenkäsittelyä” -kehote tuottaisi jotain uskottavaa mutta käyttökelvotonta, sillä kumpikaan osapuoli – et sinä etkä agentti – tietäisi, milloin tavoite on saavutettu.

Mallipohjainen refaktorointi

Tehokkain muunnelma sisältää jo vaatimusten mukaisen tiedoston nimeämisen ja yleistyksen pyytämisen.

"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 lukee referenssikomponentin, erottaa siinä käytetyn mallin ja soveltaa sitä kohdekomponentteihin huomioiden erikoistapaukset – kuten mukautetun validoinnin tai sivuvaikutukset – sen sijaan, että se tekisi sokean korvauksen. Käytännön seuraus on mielenkiintoinen: ensimmäinen komponentti, jonka siirrät itse, maksaa kaikkien muiden puolesta. Panosta tähän mallitiedostoon; se on spesifikaation arvoinen.

Refaktoroinnin varmentaminen

Codex ajaa testit jokaisen refaktoroinnin jälkeen, mutta testeistä läpi mennyt refaktorointi ei välttämättä ole vielä valmis toimitettavaksi. Neljä tarkistusta muodostavat minimivaatimuksen, ja kukin niistä adressoi eri riskiä.

TarkistusKomentoMitä se varmentaa
Yksikkötestitnpm run testToiminnallisuus säilynyt
Tyypitnpx tsc --noEmitEi tyyppivirheitä
Linttausnpm run lintSovitut käytännöt noudatettu
Buildinpm run buildValmis tuotantoon

Tyypillinen tilanne, joka perustelee tämän listan: tiedostojen siirtäminen jättää testit vihreiksi, koska ne tuovat moduulit barrel-tiedoston kautta, mutta rikkoo tuotantobuildin kehäriippuvuuden vuoksi, jota mikään muu ei paljasta. Lisää nämä neljä komentoa AGENTS.md-tiedostoosi, jolloin Codex ajaa ne jokaisen muutoksen jälkeen ilman, että sinun tarvitsee muistaa tai muistuttaa siitä.

Keskeiset asiat

  • Refaktorointi on tehtävä, jossa Codex tarjoaa suurimmat ajansäästöt
  • Viittaa mallitiedostoon ohjataksesi refaktorointimallia
  • Codex päivittää tuonnit ja viittaukset koko projektin laajuisesti
  • Varmista aina refaktoroinnin jälkeen testein, tyyppitarkistuksin ja buildilla
  • Dokumentoi varmentamiskomennot tiedostoon AGENTS.md