merge conflict를 안전하게 해결하기

언제 사용하나

머지나 리베이스 중 충돌이 발생해 진행이 멈췄을 때.

실행 전 확인

• 작업 백업을 위해 현재 브랜치 지점을 기억하거나 백업 브랜치를 만든다: git branch backup/{{BRANCH}}

명령

# 1) 충돌 파일 확인
git status

# 2) 각 파일을 열어 <<<<<<< ======= >>>>>>> 표시 사이를 직접 수정
#    필요하면 양쪽 버전 확인
git diff

# 3) 해결한 파일 스테이징
git add {{RESOLVED_FILE}}

# 4) 진행 마무리 (머지의 경우)
git commit            # 리베이스면: git rebase --continue

# 되돌리고 싶으면 (아직 커밋 전)
git merge --abort     # 리베이스면: git rebase --abort

placeholder 설명

• {{BRANCH}} : 현재 작업 브랜치
• {{RESOLVED_FILE}} : 해결한 파일

입력 예시

충돌난 src/App.tsx를 수정 후 git add src/App.tsx

기대 결과

양쪽 변경이 의도대로 합쳐지고 충돌 표시가 사라진다.

검증 방법

git diff --check로 충돌 표식이 남지 않았는지 확인하고 테스트를 돌린다.

주의사항과 흔한 실수

• 충돌 표식(<<<<<<<)을 지우지 않고 커밋하지 않는다.
• 헷갈리면 --abort로 되돌린 뒤 다시 시도한다.

관련 문서

• 충돌 해결: https://git-scm.com/book/ko/v2/Git-%EB%B8%8C%EB%9E%9C%EC%B9%98-%EB%B8%8C%EB%9E%9C%EC%B9%98%EC%99%80-%EB%A8%B8%EC%A7%80%EC%9D%98-%EA%B8%B0%EC%B4%88