Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Refaktorēšana un esošā koda uzlabošana

Nodarbība 6 no 20 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Vecā koda pārveidošana mūsdienīgā kodā
  2. Strukturālā refaktorēšana
  3. Koda modernizācija
  4. Kvalitātes uzlabošana
  5. Refaktorēšana, balstoties uz paraugiem
  6. Refaktorēšanas pārbaude
  7. Galvenās atziņas

Vecā koda pārveidošana mūsdienīgā kodā

Refaktorēšana ir viens no laikietilpīgākajiem uzdevumiem izstrādē, un reti kad tas tiek augstu novērtēts: neviens tevi neapsveiks par 800 rindu faila sadalīšanu. Tieši tāpēc tehniskais parāds uzkrājas sprintu pēc sprinta, līdz tas kļūst par patieso jūsu darba palēnināšanās cēloni. Codex samazina stundām ilgu manuālu darbu līdz minūtēm, vienlaikus saglabājot esošo uzvedību – vienīgo lietu, kas refaktorēšanā tiešām ir svarīga.

Strukturālā refaktorēšana

Visbiežāk sastopamais gadījums ir universālais fails, kuru neviens neuzdrošinās aiztikt, jo tas tiek importēts 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 izcili tiek galā ar šāda veida uzdevumiem: tas identificē funkcijas, sagrupē tās pēc tēmām, izveido jaunus failus un pēc tam atjaunina visus importus visā projektā. Tieši pēdējais solis parasti attur no manuālas refaktorēšanas – četrdesmit faili, kas jālabo, viens aizmirsts imports, un būve sabrūk visneīstākajā brīdī. Rezultāts ir objektīvi pārbaudāms: ja testi strādāja iepriekš un strādā arī tagad, sadalījums ir pareizs.

Koda modernizācija

Otrs lielais gadījums ir pāreja uz mūsdienīgiem risinājumiem, kur transformācija ir mehāniska, taču tik atkārtojoša, ka to pastāvīgi atliek uz vēlāku laiku.

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

Sākumpunkts ir uz atgriezeniskajiem zvaniem (callbacks) balstīts JavaScript ar kaskādes veida kļūdu apstrādi:

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

Lūk, ko ģenerē Codex:

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

Vienā piegājienā notikušas trīs lietas: parādījušies TypeScript tipi, atgriezeniskie zvani nomainīti pret async/await, un kļūdu apstrāde vienkāršota, jo izņēmumi tagad tiek pārraidīti dabiskā ceļā. Biznesa loģika paliek identiska – un tieši to tu pārbaudi apskates laikā, nevis rezultāta eleganci.

Kvalitātes uzlabošana

Tu vari mērķēt arī uz konkrētu kvalitātes dimensiju, nevis sintaktisku transformāciju, ja vien uzskaiti prasības.

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

Šādi formulēts pieprasījums kļūst pārbaudāms punktu pa punktam apskates laikā. Atsevišķs „uzlabo kļūdu apstrādi” uzdevums radītu kaut ko ticamu, bet nelietojamu, jo nedz tu, nedz aģents nezinātu, kad mērķis ir sasniegts.

Refaktorēšana, balstoties uz paraugiem

Visiedarbīgākais variants ir norādīt jau atbilstošu failu un pieprasīt vispārinājumu.

"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 nolasa atsauces komponenti, izdala paraugu un piemēro to mērķa komponentēm, vienlaikus risinot robežgadījumus – pielāgotu validāciju, blakusparādības –, nevis veicot aklu aizvietošanu. Praktiskā nozīme ir interesanta: pirmā komponente, ko migrē pats, atmaksājas par visām pārējām. Ieguldi rūpes šajā paraugfailā; tas ir vērts specifikācijas.

Refaktorēšanas pārbaude

Codex pēc katras refaktorēšanas palaiž testus, taču refaktorēšana, kas iztur testus, ne vienmēr ir gatava ražošanai. Četras pārbaudes veido minimumu, un katra novērš atšķirīgu risku.

PārbaudeKomandaKo tā verificē
Vienības testinpm run testUzvedība saglabāta
Tipinpx tsc --noEmitNav tipu kļūdu
Lintēšananpm run lintIevērotas konvencijas
Būvenpm run buildGatava ražošanai

Tipisks gadījums, kas attaisno šo sarakstu: failu pārvietošana atstāj testus „zaļus”, jo tie importē no bara faila, bet sabojā ražošanas būvi apļveida importa dēļ, ko nekas cits neatklāj. Pievieno šīs četras komandas savam AGENTS.md failam, un Codex tās izpildīs pēc katras izmaiņas, tev par to nedomājot un to neatgādinot.

Galvenās atziņas

  • Refaktorēšana ir uzdevums, kurā Codex nodrošina vislielāko laika ietaupījumu
  • Izmanto paraugfailu, lai vadītu refaktorēšanas paraugu
  • Codex atjaunina importus un atsauces visā projektā
  • Pēc refaktorēšanas vienmēr veic pārbaudi ar testiem, tipu pārbaudi un būvi
  • Dokumentē pārbaudes komandas failā AGENTS.md