Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Meglévő kód refaktorálása és javítása

6. lecke 20 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Örökölt kód átalakítása modern kóddá
  2. Strukturális refaktorálás
  3. Kód modernizálása
  4. Minőségjavítás
  5. Mintaalapú refaktorálás
  6. A refaktorálás ellenőrzése
  7. Főbb megállapítások

Örökölt kód átalakítása modern kóddá

A refaktorálás a fejlesztés egyik legidőigényesebb feladata, és ritkán a legjobban díjazott: senki nem gratulál neked, mert szétvágtál egy 800 soros fájlt. Pont ezért halmozódik fel sprintről sprintre, amíg a lassulásod valódi okává nem válik. A Codex órányi manuális munkát percekre csökkent, miközben megőrzi a meglévő működést – ez az egyetlen dolog, ami egy refaktorálásnál igazán számít.

Strukturális refaktorálás

A leggyakoribb eset az a mindent befogadó fájl, amelyhez senki nem mer hozzányúlni, mert mindenhol importálják.

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

A Codex kiválóan kezeli az ilyen típusú feladatokat: azonosítja a függvényeket, témák szerint csoportosítja őket, létrehozza az új fájlokat, majd frissíti az összes importot a projektben. Ez az utóbbi lépés az, ami általában elriaszt a manuális refaktorálástól – negyven fájlt kell javítani, egyetlen elmaradt import, és a build a legrosszabb pillanatban elhasal. Az eredmény pedig objektíven ellenőrizhető: ha a tesztek előtte lefutottak, és most is lefutnak, akkor a szétválasztás helyes.

Kód modernizálása

A másik nagy eset a modern mintákra való átállás, ahol az átalakítás mechanikus, de annyira ismétlődő, hogy folyamatosan hátrébb sorolják a backlogban.

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

A kiindulópont a visszahívásokon (callback) alapuló JavaScript, a lépcsőzetes hibakezelésével:

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

Íme, amit a Codex előállít:

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

Három dolog történt egyetlen lépésben: megjelentek a TypeScript típusok, a visszahívásokat felváltotta az async/await, és a hibakezelés leegyszerűsödött, mivel a kivételek most természetesen propagálódnak. Az üzleti logika változatlan marad – és pontosan ezt ellenőrzöd a review során, nem az eredmény eleganciáját.

Minőségjavítás

Célozhatsz egy adott minőségi dimenzióra is szintaktikai átalakítás helyett, feltéve, hogy felsorolod a követelményeket.

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

Így megfogalmazva a kérés pontonként ellenőrizhetővé válik a review során. Egy önálló „javítsd a hibakezelést“ prompt valami hihető, de használhatatlan eredményt szülne, mert sem te, sem az ágens nem tudná, mikor teljesült a cél.

Mintaalapú refaktorálás

A leghatékonyabb változat, amikor kijelölsz egy már megfelelős fájlt, és kéred az általánosítást.

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

A Codex beolvassa a referencia komponenst, kinyeri a mintát, és alkalmazza azt a célkomponensekre, kezelve a szélsőséges eseteket – egyedi validáció, mellékhatások –, ahelyett, hogy vakon helyettesítene. A gyakorlati következmény érdekes: az első komponens, amit te magad migrálsz, megfizeti az árát az összes többinek. Fordíts gondot erre a modellfájlra; megér egy specifikációt.

A refaktorálás ellenőrzése

A Codex minden refaktorálás után lefuttatja a teszteket, de egy teszteken átesett refaktorálás még nem feltétlenül élesíthető. Négy ellenőrzés alkotja a minimumot, és mindegyik egy másik kockázatot kezel.

EllenőrzésParancsAmit ellenőriz
Egységteszteknpm run testA működés megmaradt
Típusoknpx tsc --noEmitNincsenek típushibák
Lintelésnpm run lintA konvenciók betartva
Buildnpm run buildÉlesítésre kész

A tipikus eset, ami indokolja ezt a listát: a fájlok áthelyezése zölden hagyja a teszteket, mert azok egy barrel fájlból importálnak, de elrontja az éles buildet egy körkörös import miatt, amit más nem tár fel. Add hozzá ezt a négy parancsot az AGENTS.md fájlodhoz, és a Codex minden változtatás után lefuttatja őket anélkül, hogy gondolnod kellene rá, vagy emlékeztetned kellene.

Főbb megállapítások

  • A refaktorálás az a feladat, ahol a Codex a legtöbb időmegtakarítást nyújtja
  • Hivatkozz egy modellfájlra a refaktorálási minta vezérléséhez
  • A Codex frissíti az importokat és hivatkozásokat a teljes projektben
  • Refaktorálás után mindig ellenőrizz tesztekkel, típusellenőrzéssel és buildeléssel
  • Dokumentáld az ellenőrző parancsokat az AGENTS.md fájlban