merge 충돌을 어떻게 효과적으로 해결하나요?

Question

Accepted Answer

**merge 충돌(conflict)**은 Git이 변경 사항을 자동으로 합칠 수 없을 때(양쪽이 같은 라인을 수정) 발생합니다. 충돌을 해결하는 것은 충돌 마커를 이해하고, 올바른 결과를 결정하며, merge를 완료하는 것을 포함합니다. 이를 자신 있게 하는 것이 중요한 실무 기술입니다. ## 충돌이 언제, 왜 발생하나 ```text Git은 대부분의 변경을 자동 merge하지만, 양쪽 branch가 SAME 라인을 변경했을 때(또는 한쪽이 다른 쪽이 수정한 것을 삭제) 충돌이 발생 — Git이 결정할 수 없어 사용자에게 요청. → 충돌은 협업에서 정상이며 오류가 아님 — 단지 Git이 자동 해결할 수 없는 변경. ``` ## 충돌 마커 이해하기 ```text <<<<<<< HEAD 현재 branch(merge 대상)의 코드 ======= 다른 branch(merge되는 쪽)의 코드 >>>>>>> feature-branch ``` ```text → <<<<<<< 부터 ======= : 내 쪽(HEAD) → ======= 부터 >>>>>>> : 상대 쪽 → 올바른 최종 결과(한쪽, 다른 쪽, 또는 조합)로 편집한 다음, 모든 마커를 제거. ``` ## 단계별 해결 ```bash git status # 어떤 파일에 충돌이 있는지 확인 # 각 충돌 파일을 열고; 각 충돌마다: # 올바른 결과 결정(내 것 유지, 상대 것, 또는 조합), 마커 제거 git add # 충돌이 해결되었음을 표시 git commit # (merge의 경우) merge 완료 # git merge --abort # 또는 완전히 중단하고 다시 시작 ``` ## 효과적으로 하기 ```text ✓ 선택 전에 양쪽을 이해 — 무턱대고 한쪽을 유지하지 말 것; 각각이 왜 변경됐는지 알 것 ✓ 도구 사용 — IDE merge 도구 / git mergetool이 양쪽 + base를 시각적으로 보여줌(더 쉬움) ✓ 해결 후 테스트 — 해결된 충돌도 논리적으로 틀릴 수 있음(컴파일/테스트 실행) ✓ 변경 의도가 불명확하면 다른 작성자와 소통 ✓ 더 작고 빈번한 merge/pull → 더 적고 단순한 충돌(긴 분기 회피) ``` ## 왜 중요한가 merge 충돌을 효과적으로 해결하는 것은 중요하고 자주 필요한 실무 기술입니다. 충돌은 **협업의 불가피하고 정상적인 부분**(여러 사람이 같은 코드를 변경할 때마다)이고 자신 있게 처리하는 것이 필수적이지만, 이를 이해하지 못하는 사람에게는 흔한 불안과 실수의 원천이기 때문입니다. **충돌이 정상이며 오류가 아니라는** 점(양쪽이 같은 라인을 수정하여 Git이 자동 해결할 수 없는 변경일 뿐)을 이해하면 두려움이 사라지고 올바르게 바라보게 됩니다. 핵심 실무 기술은 **충돌 마커**(`<<<<<<<` HEAD/내 쪽, `=======`, `>>>>>>>` 상대 쪽)를 이해하여 무엇이 충돌하는지 읽을 수 있는 것과, **해결 과정**(올바른 최종 결과를 결정 — 한쪽, 다른 쪽, 또는 사려 깊은 조합을 유지 — 마커를 제거한 다음 stage하고 merge 완료)입니다. 이를 **효과적으로** 하는 것이 중요합니다. **선택 전에 양쪽을 이해**(무턱대고 한쪽을 유지하지 말고 각각이 왜 변경됐는지 알 것), **merge 도구 사용**(양쪽과 base를 시각적으로 보여주어 해결을 쉽게 함), 그리고 결정적으로 **해결 후 테스트**(문법적으로 해결된 충돌도 논리적으로 틀릴 수 있으므로 — 컴파일하고 테스트를 실행하면 이를 잡음)는 해결 중 버그 도입을 방지합니다. 더 작고 빈번한 merge가 충돌을 줄인다는 점을 아는 것은 좋은 예방 관행입니다. 충돌은 협업 개발에서 불가피하고 이를 올바르게 해결(양쪽 이해, 올바른 결과 선택, 검증)하는 것이 오류 없이 작업을 통합하는 데 필요하므로, merge 충돌을 효과적으로 해결하는 것은 팀에서 작업하는 모든 개발자에게 필수적이고 자주 적용되는 실무 기술입니다. 이는 흔한 스트레스 원천을 일상적이고 자신 있는 작업으로 바꾸며, 동시 변경의 불가피한 통합 중 코드 정확성에 직접 영향을 미치는 중요한 역량입니다.