git branch 가 여러개 일때 생길 수 있는 충돌&해결 방법 정리

팀 프로젝트를 진행하며 여러 branch를 사용하게 되면서 로컬에서 수정한 파일이 날라가는 이슈가 생겼다.

그래서 그것을 해결하면서 이러한 상황에서 생길 수 있는 충돌 이슈들과 그것들에 대한 해결 방법을 정리해 보았다.

 

🛠️ git pull 시 충돌 (Merge Conflict)

이슈

• 로컬에서 수정한 파일이 원격 저장소(리모트)의 변경 사항과 충돌하는 경우 발생
• git pull 시 자동 병합이 실패하고, 충돌 해결이 필요함

해결 방법

1. git status 명령어를 통해 충돌이 발생한 파일 목록을 확인
2. 해당 파일을 열어 <<<<<<< HEAD, =======, >>>>>>> branch_name 등의 충돌 표시를 보고 직접 수정
3. git add "충돌 해결 파일" 진행
4. git commit -m "Resolve merge confilct"진행

 

🛠️ git pull 시 fast-forward vs merge commit 문제

이슈

• git pull 시 fast-forward 병합과 merge commit 중 어떤 방식으로 병합할지 선택해야 함
• merge commit이 필요 없는 상황에서도 자동으로 생성되는 경우가 있음

해결 방법

• git pull --rebase를 사용하면 불필요한 merge commit 없이 리베이스로 깔끔하게 병합 가능:

git pull --rebase

 

🛠️ git push 시 rejected (non-fast-forward)

이슈

• 다른 팀원이 원격 저장소를 업데이트했는데, 내 로컬 브랜치가 뒤처진 경우 발생
• git push 시 다음과 같은 에러가 뜸: 
•  
  ! [rejected] main -> main (non-fast-forward)

해결 방법

1. 로컬 변경 사항을 우선적으로 커밋 또는 스태시
   • git stash
2. ✨최신 원격 변경 사항 가져오기(--rebase 사용 시, 내 변경 사항이 최신 커밋 위에 다시 적용됨.)
   • git pull --rebase
3. 스태시 복원 후 충돌 해결 (필요 시)
   • git stash pop
4. 푸시 재시도
    

 

🛠️  git clone 후 git pull 시 "fatal: refusing to merge unrelated histories"

이슈

• 서로 다른 Git 이력을 가진 프로젝트를 합치려 할 때 발생

해결 방법

• --allow-unrelated-histories 옵션을 추가하여 강제 병합:
• 단, 이 옵션을 사용할 경우 반드시 병합 충돌을 확인하고 정리해야 함

git pull origin main --allow-unrelated-histories

 

 

🛠️ 특정 브랜치만 git pull 하려는데 전체 브랜치가 업데이트됨

이슈

• git pull 하면 fetch + merge가 동시에 일어나기 때문에 원치 않는 변경이 포함될 수 있음.

해결 방법

특정 브랜치만 가져오려면 git fetch 후 git merge를 개별적으로 실행 : 

git fetch origin feature-branch git merge origin/feature-branch

 

또는 단순히 원격의 최신 상태만 확인하려면 : 

git fetch --prune

 

 

🛠️ 원격 브랜치 삭제 후 로컬에서 git pull 시 브랜치가 남아있음

이슈

• 원격 저장소에서 브랜치를 삭제했는데 로컬에서 여전히 보이는 문제.

해결 방법

1. 로컬에서 원격 삭제된 브랜치 정리
    

   git fetch --prune
2. 혹은 직접 삭제
    

   git branch -d branch-name

 

🛠️ gitignore 적용이 안됨

이슈

• .gitignore에 추가했음에도 불구하고 특정 파일이 계속 Git에 포함됨.

해결 방법

1. 이미 Git에 추적된 파일은 .gitignore에 추가해도 무시되지 않음.
   해당 파일을 캐시에서 제거 후 다시 .gitignore 적용:
    

   git rm -r --cached <파일명 또는 디렉토리명>

다시 커밋 후 푸시:

git commit -m "Remove ignored files" git push

 

 

 

💡 오늘 발생한 문제의 해결) git pull --rebase를 이용!

우리는 dev에 2명이상의 리뷰어가 승인한 코드를 올리고 중간에 계속 최신 변경 사항을 가져와서 사용했다.

그때, 내 로컬에 새로운 코드와 최신 변경 사항이 충돌하는 이슈가 생겼다.

그래서 나는 충돌 문제를 해결하고 rebase를 사용해서 그 뒤부터는 안전하게 코드를 업데이트 할 수 있었다. 

 

rebase의 동작 과정  :

1. 원격 브랜치의 최신 변경 사항을 가져옴 (git fetch origin dev)
2. 내 로컬 커밋들을 임시로 저장 (git stash 와 같은 효과)
3. 원격 브랜치 (origin/dev)를 내 로컬 브랜치로 Fast-Forward
4. 저장해 둔 내 로컬 커밋들을 최신 브랜치 위에서 하나씩 다시 적용 

o---o---A (origin/dev 최신 커밋)
         \
          B'--C' (내 로컬 작업이 최신 커밋 위로 재적용됨)

 

git pull --rebase 의 장점 : 

• 불필요한 merge commit 방지
• 이력이 깔끔하게 정리됨 (한 줄로 이어지는 commit log)
• 협업 시 다른 개발자와 충돌 방지

 

주의 사항 

• rebase는 내 로컬 변경 사항을 새 커밋처럼 다시 적용하기 때문에 이미 원격에 푸시된 것을 리베이스 하면 안됨
• 충돌 발생 시 직접 해결 후 git rebase --continue 필요

 

따라서 

git pull origin dev --rebase

명령어는 불필요한 merge commit을 피하고 깔끔한 커밋 히스토리를 유지해줄 수 있으며 충돌을 줄여주는 명령어로 

팀 프로젝트뿐만 아니라 여러 브랜치를 관리할때 유용하게 쓸 수 있다.