[Git] 병합(Merge) 충돌 방지를 위한 리베이스 Rebase

merge 충돌 방지를 위한 리베이스(Rebase) ⭐️

---

PR 보내기 전 다른 사람이 새로운 커밋을 추가한 상태라면 충돌 방지를 위해 로컬 레포지토리를 최신화하고(upstream ⇄ origin 레포지토리 동기화), 현재 작업중인 기능/버그 브랜치의 base를 develop 브랜치의 마지막 커밋으로 변경하는 리베이스(Rebase) 작업이 필요하다 — 참고글1 | 참고글2

 

❶ 현재 상태

# 현재 위치 feature-branch 8번 커밋
1 - 2 - 3 - 5 (devlop)
     \
      4 - 6 - 7 - 8 (feature-branch)

• develop 브랜치의 1~2 커밋 : 로컬 레포지토리의 develop 브랜치 커밋
• develop 브랜치의 3~5 커밋 : 원격(upstream) 레포지토리에서 새로 추가한 커밋
• feature-branch 브랜치의 4~8 커밋 : 로컬에서 현재 작업중인 커밋

 

❷ develop 브랜치로 이동 후 업스트림과 동기화 e.g. git pull upstream develop

# 최신화 후 현재 위치 develop 5번 커밋
1 - 2 - 3 - 5 (devlop)
     \
      4 - 6 - 7 - 8 (feature-branch)

 

❸ feature-branch 브랜치로 이동 후 리베이스 e.g. git rebase develop

# 현재 위치 feature-branch 8번 커밋
1 - 2 - 3 - 5 (devlop)
             \
              4 - 6 - 7 - 8 (feature-branch)

 

❹ origin/feature-branch로 push e.g. git push origin feature-branch

 

❺ origin 레포지토리에서 upstream/develop으로 PR

 

충돌 상황에서 Rebase

---

1. origin/develop 최신화 (upstream/develop과 동기화)
2. [로컬] git pull origin develop
3. [로컬] feature-branch 이동 후 리베이스 e.g. git rebase develop
4. 충돌 파일 해결
5. 리베이스 진행 e.g. git rebase --continue
6. origin/feature-branch로 push

 

💡 원격 저장소의 최신 내용을 가져오라는 에러가 발생하면?

강제 push로 진행하면 된다. 리베이스는 커밋의 변경 사항(diff)을 patch라는 임시 저장소에 옮긴 후, base 브랜치 뒤에 새로운 커밋을 만들고 patch에 임시 저장한 변경사항을 적용한다. diff는 동일하지만 commit hash가 달라져서 pull 하라는 에러가 발생하는 것.

 

강제 push는 --force 옵션을 주면 된다. 하지만 리베이스하는 동안 누군가 새로운 commit을 원격에 추가했다면 리베이스 버전을 원격 버전에 덮어쓰므로 새로운 커밋은 사라진다.

 

이런 문제를 방지하기 위해 리베이스한 버전과 원격 버전이 동일할 때만(원격에 새로운 커밋이 없을때만) 강제 push를 진행하는 --force-with-lease 옵션을 사용하는게 좋다.

 

e.g. git push origin feature-branch --force-with-lease

 

로컬 브랜치 최신화 참고

---

upstream ⇄ origin sync (참고 문서)

1. 터미널 사용 시
   • local에서 upstream fetch : e.g. git fetch upstream
   • local에서 가장 최신 commit으로 checkout : e.g. git checkout develop
   • upstream 변경사항을 현재 브랜치에 merge : e.g. git merge upstream/develop
   • local 변경사항을 origin 레포지토리로 push : e.g. git push origin develop
2. GitHub CLI 사용시
   • fetch 및 merge : e.g. gh repo sync owner/cli-fork
   • local 변경사항을 origin 레포지토리로 push

 

원격 저장소의 상세 정보 확인

git remote show origin