스낵깃 🍪 - 중급편 #8: Rebase 중 발생하는 충돌 해결하기

🔹 Rebase 중 발생하는 충돌 해결법

Git을 사용하면서 Merge Conflict(병합 충돌)은 한 번쯤 겪어봤을 것이다.

그러나 Git을 더욱 깔끔하게 사용하기 위해 Rebase를 진행하는 과정에서 충돌이 발생할 수도 있다.

 

💡 “Merge 충돌과 Rebase 충돌의 차이는 무엇일까?”

💡 “Rebase 중 충돌이 발생하면 어떻게 해결해야 할까?”

 

이 글에서는 Rebase 중 충돌이 발생하는 이유와 이를 해결하는 방법을 단계별로 정리한다.

---

1️⃣ Rebase란?

git rebase는 한 브랜치의 기반(base)을 변경하여 최신 커밋 위로 재배치하는 과정이다.

즉, 기존 브랜치의 커밋을 다른 브랜치의 최신 상태를 반영한 후 다시 적용하는 방식이다.

🔹 Merge와 Rebase의 차이

비교 항목	Merge	Rebase
이력 구조	브랜치가 병합되며, 분기된 기록 유지	기존 커밋을 기반으로 재적용하여 단일 이력 생성
병합 커밋	새 병합 커밋(merge commit)이 생성됨	병합 커밋 없이 히스토리가 정리됨
충돌 해결 방식	병합 시 한 번만 충돌 해결	개별 커밋을 재적용하면서 충돌 발생 가능
사용 사례	협업에서 브랜치 간 변경 사항을 명확히 남겨야 할 때	개인 작업을 정리하거나 깔끔한 히스토리를 유지할 때

 

📌 즉, Rebase는 기존 브랜치를 새로운 기반 위에 다시 적용하는 방식이므로, 충돌이 발생할 확률이 높다.

---

2️⃣ Rebase 중 충돌이 발생하는 이유

Rebase는 각 커밋을 하나씩 재적용하는 과정이기 때문에,

✅ 기존 코드와 충돌하는 변경 사항이 있다면 Rebase가 중단될 수 있다.

 

Rebase 도중 충돌이 발생하는 대표적인 이유는 다음과 같다.

 

1️⃣ 기존 커밋에서 수정한 파일을, Rebase하려는 브랜치에서도 변경한 경우

2️⃣ 삭제된 파일을 Rebase 도중 다시 수정하려고 할 경우

3️⃣ Rebase 도중 적용하려는 변경 사항과 현재 코드가 일치하지 않는 경우

 

⚡ 즉, Git이 “어느 쪽의 변경 사항이 맞는지 모르겠다!“라고 판단할 때 충돌이 발생한다.

---

3️⃣ Rebase 중 충돌 해결 방법

Rebase 도중 충돌이 발생하면 Git은 다음과 같은 메시지를 띄운다.

error: could not apply 123abc... Fix typo in README

 

📌 이 메시지는 무엇을 의미할까?

• 123abc → Rebase 중이던 특정 커밋의 해시 값
• "Fix typo in README" → 해당 커밋 메시지
• “이 커밋을 적용하려다 충돌이 발생했으니 해결해야 한다!”

이제 해결해 보자.

1️⃣ Rebase 진행 중 상태 확인하기

git status

✅ Git이 충돌이 발생한 파일을 출력해 준다.

✅ 이 파일들을 수정해야 Rebase를 계속 진행할 수 있다.

---

2️⃣ 충돌이 발생한 파일 수정하기

충돌이 발생한 파일을 열어보면, Git이 Conflict Markers(충돌 표시)를 남겨 놓는다.

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

✅ HEAD 아래는 현재 브랜치(main)의 코드

✅ ======= 아래는 Rebase 도중 적용하려는 코드

 

🔹 원하는 코드로 수정한 후 저장한다.

console.log("최종 코드: 최신 브랜치 코드 반영!");

---

3️⃣ 수정한 파일을 Git에 반영하고 Rebase 계속 진행하기

git add <충돌 파일>
git rebase --continue

✅ git add . → 충돌 해결한 파일을 스테이징

✅ git rebase --continue → Rebase를 계속 진행

 

📌 Rebase가 완전히 끝날 때까지 이 과정을 반복할 수 있다.

---

4️⃣ Rebase 도중 실수했을 때 되돌리기

Rebase 도중 실수하거나,

“아, 이거 그냥 다시 처음부터 해야겠다!🤦🏻‍♀️” 싶다면 아래 명령어를 사용하면 된다.

 

1️⃣ Rebase를 완전히 중단하고 원래 상태로 되돌리기

git rebase --abort

✅ Rebase를 시작하기 전 상태로 돌아간다.

✅ 아무것도 변경되지 않은 상태로 초기화됨.

---

2️⃣ 현재 충돌난 커밋만 건너뛰기

git rebase --skip

✅ 충돌이 발생한 커밋을 건너뛰고(Rebase에서 제외하고) 계속 진행.

✅ 하지만, Rebase 이후 변경 사항이 제대로 반영되지 않을 수도 있으므로 주의가 필요하다.

---

3️⃣ 충돌 해결 후 Rebase 계속 진행하기

git rebase --continue

✅ 수정한 파일을 Git에 반영한 후, Rebase를 계속 진행한다.

---

5️⃣ Rebase 충돌 해결 과정 정리

단계	명령어	설명
1️⃣	git status	충돌 발생한 파일 확인
2️⃣	파일 수정	<<<<<<< ======= >>>>>>> 사이의 코드 수정
3️⃣	git add <파일명>	수정한 파일 Git에 반영
4️⃣	git rebase --continue	Rebase 계속 진행
💡	git rebase --abort	Rebase 중단 (되돌리기)
💡	git rebase --skip	현재 충돌 커밋 건너뛰기

---

🔹 결론

• Rebase는 Git 히스토리를 깔끔하게 유지하는 강력한 도구이다.
• 하지만 충돌이 발생하면 Merge보다 복잡한 과정이 필요할 수 있다.
• 충돌이 발생했을 때 차근차근 해결하면 된다.
• 만약 실수했다면 git rebase --abort로 되돌릴 수도 있다.

 

🔥 Rebase를 활용하면 협업 중에도 더 깔끔한 Git 이력을 유지할 수 있다!

다음 글에서는 Rebase를 활용한 실전 Git 정리법을 다룰 예정이다. 🚀