Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Esamo kodo refaktorizavimas ir tobulinimas

Paskaita 6 iš 20 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Seno kodo transformavimas į šiuolaikinį kodą
  2. Struktūrinis refaktorizavimas
  3. Kodo modernizavimas
  4. Kokybės gerinimas
  5. Refaktorizavimas pagal šablonus
  6. Refaktorizavimo tikrinimas
  7. Svarbiausi punktai

Seno kodo transformavimas į šiuolaikinį kodą

Refaktorizavimas – viena laiko reikalaujančių užduočių kuriant programinę įrangą, ir retai kada už ją sulaukiama pagyrimų: niekas tavęs nepagirs už tai, kad padalijai 800 eilučių failą. Būtent todėl jis kaupiasi sprintas po sprinto, kol tampa tikrąja tavo darbo lėtėjimo priežastimi. „Codex“ valandų trukmės rankinį darbą sutrumpina iki minučių, išlaikydamas esamą elgseną – o tai vienintelis dalykas, kuris refaktorizuojant tikrai svarbus.

Struktūrinis refaktorizavimas

Dažniausias atvejis – universalus failas, kurio niekas nedrįsta liesti, nes jis importuojamas visur.

"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“ puikiai tvarkosi su šio tipo užduotimis: jis identifikuoja funkcijas, sugrupuoja jas pagal temas, sukuria naujus failus ir tada atnaujina visus projekte esančius importus. Būtent paskutinis žingsnis dažniausiai atbaido nuo rankinio refaktorizavimo – reikia sutvarkyti keturiasdešimt failų, praleidus vieną importą, ir kūrimo procesas sugenda pačiu netinkamiausiu momentu. Rezultatas yra objektyviai patikrinamas: jei testai veikė anksčiau ir veikia dabar, padalijimas atliktas teisingai.

Kodo modernizavimas

Kitas didelis atvejis – perėjimas prie šiuolaikinių šablonų, kai transformacija yra mechaninė, tačiau tokia pasikartojanti, kad nuolat nukeliama į darbų sąrašo galą.

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

Pradinis taškas – „callback“ pagrindu veikiantis „JavaScript“ su pakopiniu klaidų apdorojimu:

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

Štai ką sukuria „Codex“:

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

Vieno praėjimo metu įvyko trys dalykai: atsirado „TypeScript“ tipai, „callback“ funkcijas pakeitė „async/await“, o klaidų apdorojimas supaprastėjo, nes išimtys dabar plinta natūraliai. Verslo logika lieka identiška – ir būtent tai tikrini peržiūros metu, o ne rezultato eleganciją.

Kokybės gerinimas

Galite siekti ne sintaksinės transformacijos, o konkrečios kokybės dimensijos gerinimo, jei tik išvardijate reikalavimus.

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

Suformuluotas tokiu būdu, prašymas tampa lengvai patikrinamas punktų pagrindu peržiūros metu. Atskiras prašymas „gerinti klaidų apdorojimą“ sugeneruotų ką nors tikėtino, bet nenaudojamo, nes nei tu, nei agentas nežinotumėte, kada tikslas pasiektas.

Refaktorizavimas pagal šablonus

Galingiausias variantas – nurodyti jau standartus atitinkantį failą ir paprašyti jį apibendrinti.

"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“ nuskaitys etaloninį komponentą, išskirs šabloną ir pritaikys jį tiksliniams komponentams, atsižvelgdamas į kraštutinius atvejus – individualų validavimą, šalutinius efektus – užuot atlikęs aklą pakeitimą. Praktinė išvada įdomi: pirmasis komponentas, kurį perkeli pats, „atperka“ visus kitus. Skirk dėmesio šiam modeliniam failui; jis vertas specifikacijos.

Refaktorizavimo tikrinimas

„Codex“ po kiekvieno refaktorizavimo paleidžia testus, tačiau refaktorizavimas, praėjęs testus, nebūtinai yra paruoštas diegimui. Keturi patikrinimai sudaro minimumą, ir kiekvienas jų sprendžia skirtingą riziką.

PatikrinimasKomandaKą tikrina
Vienetiniai testainpm run testElgsena išsaugota
Tipainpx tsc --noEmitNėra tipų klaidų
Lintinimasnpm run lintLaikomasi konvencijų
Kūrimasnpm run buildParuošta produkcijai

Tipinis atvejis, pateisinantis šį sąrašą: failų perkėlimas palieka testus žalius, nes jie importuoja iš bendro failo, bet sugadina produkcijos kūrimą dėl žiedinio importo, kurio niekas kitas neatskleidžia. Įtrauk šias keturias komandas į savo „AGENTS.md“ failą, ir „Codex“ jas vykdys po kiekvieno pakeitimo, tau nereikės apie tai galvoti ar jo priminti.

Svarbiausi punktai

  • Refaktorizavimas – užduotis, kurioje „Codex“ suteikia didžiausią laiko taupymą
  • Naudok modelinį failą refaktorizavimo šablonui nukreipti
  • „Codex“ atnaujina importus ir nuorodas visame projekte
  • Po refaktorizavimo visada patikrink testais, tipų tikrinimu ir kūrimu
  • Dokumentuok tikrinimo komandas faile AGENTS.md