git merge 충돌 해결 가이드: --no-ff 전략과 안전한 병합 절차 정리

git merge 충돌 해결 가이드: --no-ff 전략과 안전한 병합 절차 정리

git merge는 팀 협업 결과를 통합하는 단계다. 충돌이 발생해도 절차를 고정하면 빠르게 복구하고 안정적으로 병합할 수 있다.

병합 전후 브랜치 개념도 (출처: Pro Git, git-scm.com)

기본 사용법

git switch main
git merge feature/checkout-refactor

자주 쓰는 옵션 4가지

항목	의미	언제 쓰는지(실무 상황)
--no-ff	항상 merge commit 생성	기능 단위 이력을 명확히 남기고 싶을 때
--ff-only	fast-forward만 허용	히스토리 단순화를 강제할 때
--squash	여러 커밋을 하나로 반영	리뷰 후 잡다한 커밋을 정리할 때
--abort	진행 중 병합 취소	충돌 규모가 커서 병합을 다시 설계할 때

문제 상황

상황: 병합 충돌을 임시로 처리해 기능이 깨진 채 main에 반영된다.
원인: 충돌 파일 테스트 없이 merge commit을 완료했다.
해결: 충돌 해결 후 단위 테스트와 주요 시나리오를 재검증한 뒤 merge를 완료한다.
예방 팁: 장수 브랜치를 피하고 자주 rebase/merge로 차이를 줄인다.

참고/출처

공식 문서: git-merge manual
공식 문서: Pro Git - Basic Branching and Merging
신뢰 자료: Atlassian - git merge