2026.08.10.
Kódolás, keretrendszerek

Biztonságos Git merge konfliktus feloldás

Temesvári László

Merge konfliktusok: Hogyan birkózz meg velük összetett brancheknél?

Üdv újra a kódfronton! Ha már egy ideje a Git hullámvasután utazol, biztosan belefutottál abba a klasszikus helyzetbe: egy igéretes új feature-t dolgoztál ki egy külön ágon, majd amikor ideje volt beolvasztani a fő ágba, a kijelződet megtámadta a félelmetes CONFLICT üzenet. Főleg, ha hosszú életű, összetett branchekről beszélünk, ahol több fejlesztő is dolgozott. Ne ess pánikba! A merge konfliktus nem hiba, hanem a Git normál működésének része. A kulcs a biztonságos és tudatos feloldás.

Mi is az valójában?

Amikor a Git két ágat próbál egyesíteni (merge), és ugyanannak a fájlnak ugyanazon a során eltérő módosításokat talál, őszintén bevallja: „Hé, ezt nem tudom automatikusan megoldani, segíts!” Ez a merge konfliktus. Különösen gyakori összetett brancheknél, ahol a feature/login-átalakítás ágad hetekkel, vagy akár hónapokkal ezelőtt ágazott le a main ágról, és azóta mindkét ágon történtek jelentős változások.

A konfliktus maga nem a baj. A baj akkor kezdődik, ha túlságosan sietve, vagy anélkül oldod fel, hogy megértenéd a két változat kontextusát, és véletlenül felülírsz valaki más munkáját, vagy bekerül egy hibás sor.

Egy tipikus helyzet képben

Képzeld el, hogy dolgozol egy új profiloldal redesignján egy feature/user-profile-v2 ágon. Eközben egy kollégád a main ágon javított egy kritikus biztonsági hibát ugyanabban a PHP backend fájlban, amit te is módosítasz a designhoz.

// user_profile.php - A MAIN ágon a kolléga javítása:
function validateUserSession($userId) {
    // Biztonsági fix: session ID ellenőrzés hozzáadva
    if (!validateSessionId($_SESSION['id'], $userId)) {
        logSecurityEvent($userId, "invalid_session_attempt");
        throw new AuthException("Érvénytelen munkamenet.");
    }
    // ... meglévő logika
    return loadUserProfileData($userId);
}
// user_profile.php - A TE FEATURE ÁGADON a redesign része:
function validateUserSession($userId) {
    // Design változás: új logging formátum a fejlesztői előnézethez
    logToDebugConsole("Profile load started for: " . $userId);
    // ... meglévő logika
    return loadUserProfileData($userId);
}

Amikor megpróbálod merge-elni a feature ágad, a Git meg fog állni. A két változat ugyanazt a függvényt módosította, de teljesen más célból. Az automatikus merge lehetetlen.

A biztonságos feloldás lépései (anélkül, hogy tutorial lennél)

Először is, nyugodj meg. A Git nem veszítette el a munkádat. Csak megállt, és jelzi, hogy segítségre van szükség. A git status parancs pontosan megmutatja, mely fájlok „unmerged” állapotban vannak.

Amikor megnyitod a konfliktusos fájlt, látni fogod a jelölőket:

<<<<<<< HEAD
// A változások a CURRENT (main) ágról
=======
// A változások a MERGING (feature) ágról
>>>>>>> feature/user-profile-v2

Itt jön a legfontosabb rész: ne válaszd csak az egyiket. Olvasd el, értsd meg *mindkét* változást. A példánkban a HEAD (main) tartalmazza a létfontosságú biztonsági javítást. A feature ágad pedig egy hasznos, de nem kritikus debug logolást. A helyes megoldás gyakran a kettő kombinációja.

// user_profile.php - A JÓ MERGE eredménye:
function validateUserSession($userId) {
    // 1. A MAIN ág kritikus biztonsági fixe MEGMARAD
    if (!validateSessionId($_SESSION['id'], $userId)) {
        logSecurityEvent($userId, "invalid_session_attempt");
        throw new AuthException("Érvénytelen munkamenet.");
    }
    
    // 2. A FEATURE ág debug infója BETEKERÜLHET (ha nem zavarja a biztonságot)
    logToDebugConsole("Profile load started for: " . $userId);
    
    // ... meglévő logika
    return loadUserProfileData($userId);
}

Ezután el kell távolítanod a <<<<<<<, =======, >>>>>>> jelzőket, és mentened a fájlt. A git add paranccsal jelzed a Git felé, hogy a konfliktust feloldottad. Végül commit.

Frontend konfliktusok: CSS, JS, markup

A konfliktusok nem csak a backend világában léteznek. Gyakoriak CSS/SCSS fájlokban vagy JavaScriptben is, főleg ha közösen dolgoztok a UI-n.

Tegyük fel, hogy a main ágon valaki Bootstrap komponenst frissített, te pedig a feature ágadon jQuery-es interaktivitást adtál hozzá ugyanahhoz a gombhoz.

// main.js a MAIN ágon:
$('#profile-save-btn').on('click', function() {
    $(this).prop('disabled', true).html('<span class="spinner-border spinner-border-sm" role="status"></span> Mentés...');
    // ... szinkron mentés logika
});
// main.js a FEATURE ágon (új design):
$('#profile-save-btn').on('click', function() {
    $(this).addClass('btn-pulse-animation'); // Új SCSS animációs osztály
    // ... új, aszinkron API hívás
});

A konfliktus feloldása itt is a funkcionalitás egyesítése lehet: a letiltás és a spinner (a main ágról) összeegyeztethető az új animációs osztállyal és az aszinkron logikával (a feature ágról). Az SCSS fájlban pedig csak ügyelj arra, hogy ne írják felül egymást a szelektorok.

Gyakori buktatók, amikbe ne ess bele

1. „A miénk a frissebb, marad!” Mentalitás. Mindig vizsgáld meg, hogy a másik ág miért változtatta meg a kódot. Egy elavultnak tűnő sor lehet egy hotfix része. 2. Túl korai konfliktusfeloldás saját branch-en. Ha a main gyakran frissül, érdemes előbb beolvasztani (merge) a main-t a saját ágadba, ott feloldani a konfliktusokat, tesztelni, és *csak utána* beolvasztani a saját ágadat a main-be. Ez fordított a „klasszikus” munkafolyamathoz képest, de sokkal biztonságosabb. 3. Nem teljes tesztelés a merge után. Miután feloldottál minden konfliktust és commitoltál, kötelező átfutni a módosított funkciókon. Egy felületesen feloldott konfliktus szépen összehozhat egy hibát, ami csak hetek múlva bukkan fel. 4. Egyedül döntesz. Ha a konfliktus egy olyan fájlban van, amit nem te írtál eredetileg, vagy nem vagy biztos a kontextusban, kérd meg a szerzőjét, hogy nézzen rá! Egy rövid üzenet vagy pair programming keretében történő feloldás óriási fejfájást takaríthat meg.

Összegzés: A konfliktus a kommunikáció eszköze

A merge konfliktus tulajdonképpen a Git módja annak, hogy rávilágítson a kódbázisban zajló párhuzamos munkák találkozására. Összetett brancheknél ez elkerülhetetlen. A biztonságos feloldás kulcsa a türelem, megértés és kontextusismeret. Ne rohanj át rajta. Használd a lehetőséget, hogy átlásd, mit csinált a csapat másik tagja. Gyakran észrevehetsz valami hasznosat vagy tanulhatsz belőle.

Legközelebb, amikor a képernyőd piros-fehér konfliktusjelzőkkel telik meg, emlékezz: ez nem katasztrófa, hanem részletekbe menő együttműködésre szólító felhívás. Vegyél egy mély levegőt, szerezz kávét, és indulj neki lépésről lépésre. A tiszta kód és a csapat nyugalma megéri az extra időt.

A weboldalon megjelenő szöveges és vizuális tartalmak előállításához mesterséges intelligenciát (AI) használunk.

Kapcsolódó cikkek