스낵깃 🍪 - 중급편 #7: Git Merge Conflict란? 원인과 해결 방법

📌 Git Merge Conflict란?

 

Git을 사용하여 협업을 진행하다 보면, Merge Conflict(병합 충돌)이 발생할 수 있다.

이는 Git이 자동으로 병합할 수 없는 경우 발생하며,

개발자가 직접 코드 충돌을 해결해야 한다.

Merge Conflict는 언제 발생할까? 🤔

• 같은 파일의 같은 줄을 두 명 이상의 개발자가 수정했을 때

• 한 브랜치에서 삭제된 파일이, 다른 브랜치에서 수정된 경우

• Rebase 도중 동일한 파일의 변경 사항이 충돌한 경우

 

Git은 자동 병합이 불가능한 경우 개발자에게 충돌을 해결하라고 알린다.

이제 Merge Conflict 해결 방법을 단계별로 살펴보자.

---

🛠 Merge Conflict 해결 방법

 

 

1️⃣ 충돌이 발생한 파일 확인

git status

✅ 충돌이 발생한 파일 목록이 출력됨

✅ 해당 파일을 열어보면 Git이 자동으로 **Conflict Markers(충돌 표시)**를 추가해준다.

 

2️⃣ 충돌 해결 (수동 해결)

충돌이 발생한 파일을 열어보면 다음과 같은 형태로 표시된다.

<<<<<<< HEAD
console.log("나는 main 브랜치 코드!");
=======
console.log("나는 feature 브랜치 코드!");
>>>>>>> feature-branch

• HEAD 아래: 현재 브랜치의 코드

• ======= 아래: 병합하려는 브랜치의 코드

 

✅ 개발자가 직접 원하는 코드를 선택하고 충돌을 해결한 후 저장하면 된다.

 

3️⃣ 충돌 해결 후 Git에 반영

git add <파일명>
git commit -m "Fix: Merge Conflict 해결"

✅ 변경 사항을 Git에 반영하고 Merge Conflict 해결 완료

 

---

🔥 자동 해결 명령어 활용

 

Git에서는 특정 브랜치의 코드만 유지할 수도 있다.

 

✅ 내 코드 유지 (--ours)

git checkout --ours <파일명>

✅ 상대 코드 반영 (--theirs)

git checkout --theirs <파일명>

 

이후 

git add .
git commit -m "Fix: Merge Conflict 해결"

 

하면 충돌 해결이 완료된다.

---

🚀 마무리하며…

 

Merge Conflict는 Git 협업에서 자주 발생하는 문제지만, 해결법을 익혀두면 두렵지 않다.

특히 git checkout --ours / --theirs 같은 자동 해결 명령어를 잘 활용하면 시간을 단축할 수 있다.

 

📌 Fork 기반 협업에서 Merge Conflict를 해결하는 방법이 궁금하다면?

➡️ 협업편 #3: Fork된 레포를 메인 레포와 동기화하며 Merge Conflict 해결하기를 참고하자!