11강. Merge Conflict 원인과 해결

?1. 이번 강의에서 해결할 문제

Git이 두 변경 중 어느 것을 남길지 판단할 수 없으면 병합을 멈춥니다. 충돌을 오류로 숨기지 않고 사람이 의도한 최종 내용을 선택해 새 커밋으로 기록합니다.

✓2. 학습 목표

✓이 강의를 마치면

• 충돌이 생기는 대표 상황을 설명합니다.
• 충돌 파일과 표식을 찾아 최종 내용을 만듭니다.
• 해결을 검증하거나 병합을 안전하게 중단합니다.

◇3. 핵심 개념

같은 파일의 같은 줄을 서로 다르게 수정하거나 한쪽이 삭제한 파일을 다른 쪽이 수정하면 자동 선택이 불가능할 수 있습니다. GitHub도 충돌이 남은 PR의 병합을 막습니다. 단순 줄 충돌은 웹에서 가능할 수 있지만 복잡한 충돌은 로컬에서 해결해야 합니다.

§4. 단계별 명령어와 예시

충돌 파일: C:\dev\git-learning-site\README.md

PowerShell

Set-Location C:\dev\git-learning-site
git switch main
git merge feature/readme-title
git status
git diff --name-only --diff-filter=U
Select-String -Path README.md -Pattern '<<<<<<<|=======|>>>>>>>'

편집기에서 표식과 불필요한 내용을 제거해 최종 문장을 만든 뒤 실행합니다.

PowerShell

git add README.md
git diff --check
git status
git commit -m "merge: resolve README title conflict"

해결 방향이 불명확하면 커밋하지 말고 git merge --abort로 병합 시작 전으로 돌아갑니다.

→5. 명령어가 동작하는 이유

충돌 중 Git은 공통 조상, 현재 브랜치, 병합 대상 버전을 index에 보관합니다. 파일을 수정하고 add하면 사람이 최종 결과를 선택했다는 뜻이 됩니다. merge --abort는 병합이 시작되기 전 상태 복원을 시도합니다.

!6. 자주 하는 실수와 안전한 해결법

!자주 하는 실수

• 표식만 지우고 내용 검토를 생략: 양쪽 요구사항을 읽고 실제 실행·빌드로 검증합니다.
• 충돌 중 다른 작업 시작: 먼저 git status의 unmerged paths를 모두 해결하거나 abort합니다.
• 모든 파일에 한쪽 버전을 일괄 적용: 정상 변경까지 잃을 수 있습니다. 파일별 의도를 확인합니다.

✎7. 직접 실습

✎직접 실습

1. 두 브랜치에서 README 같은 줄을 다르게 수정해 충돌을 재현합니다.
2. 양쪽 의미를 포함한 제3의 문장으로 해결합니다.
3. git diff --check와 프로젝트 검사를 통과한 뒤 커밋합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. Git이 충돌을 자동 해결하지 않는 이유는 무엇인가요?
2. 아직 해결되지 않은 파일만 찾는 명령은 무엇인가요?
3. 병합 해결을 포기하고 시작 전으로 돌아가는 명령은 무엇인가요?

■9. 핵심 요약

■핵심 요약

충돌 해결은 표식 제거가 아니라 의도한 최종 상태를 결정하고 검증하는 작업입니다. 불확실하면 abort해 안전하게 멈춘 뒤 요구사항을 확인합니다.