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

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

git merge는 팀 변경을 통합하는 핵심 단계다. 충돌 처리 절차를 고정하면 배포 리스크를 크게 줄일 수 있다. 초보~중급 개발자가 바로 적용할 수 있도록 명령어 흐름, 옵션 선택 기준, 복구 절차를 실무 중심으로 설명한다.

병합 흐름 예시 (출처: Pro Git, git-scm.com)

git merge 기본 사용 패턴

git switch main
git merge --no-ff feature/checkout-refactor
git push origin main

자주 쓰는 옵션 3~6개

항목	의미	언제 쓰는지(실무 상황)
--no-ff	항상 merge commit 생성	기능 단위 이력을 명확히 남길 때
--ff-only	fast-forward만 허용	예상치 못한 병합을 방지할 때
--squash	여러 커밋을 하나로 반영	잡다한 이력을 정리해 병합할 때
--abort	진행 중 merge 중단	충돌 범위가 커서 재검토할 때

실무 적용 순서

1) 실행 전 상태 확인

git status와 git log로 현재 위치를 확인한다. 특히 원격 공유 브랜치인지, 로컬 전용 브랜치인지 먼저 판단해야 안전하다.

2) 목적에 맞는 옵션 선택

동일 명령어라도 옵션에 따라 이력 보존, 충돌 위험, 협업 영향이 달라진다. 팀 정책과 배포 단계에 맞춰 옵션을 고른다.

3) 실행 후 검증

명령 실행 뒤에는 status, diff, 테스트를 통해 결과를 검증한다. 필요하면 즉시 복구 명령(reflog, revert, stash)을 연계한다.

문제 상황 1개

상황: 충돌을 임시 수정한 채 병합해 운영 장애가 발생했다.
원인: 충돌 해결 후 테스트 없이 merge commit을 확정했다.
해결: 충돌 해결 뒤 단위/통합 테스트와 핵심 플로우 검증을 완료한 후 병합한다.
예방 팁: 장수 브랜치를 피하고 자주 통합해 충돌 규모를 줄인다.

참고/출처

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