git revert로 안전하게 되돌리기: 공유 브랜치 커밋 취소와 충돌 해결 방법

git revert로 안전하게 되돌리기: 공유 브랜치 커밋 취소와 충돌 해결 방법

git revert는 이력을 지우지 않고 반대 변경을 새 커밋으로 남겨 협업 환경에서 가장 안전한 복구 전략으로 쓰인다. 초보~중급 개발자가 바로 적용할 수 있도록 명령어 흐름, 옵션 선택 기준, 복구 절차를 실무 중심으로 설명한다.

공식 Git 로고 (출처: git-scm.com)

git revert 기본 사용 패턴

git log --oneline -n 5
git revert --no-edit a1b2c3d
git push origin main

자주 쓰는 옵션 3~6개

항목	의미	언제 쓰는지(실무 상황)
--no-edit	기본 revert 메시지로 바로 커밋	긴급 롤백에서 속도가 중요할 때
--no-commit	커밋하지 않고 변경만 적용	여러 revert를 하나로 묶어 커밋할 때
-m	merge 커밋 revert 시 기준 parent 지정	잘못 병합된 merge를 되돌릴 때
--continue	충돌 해결 후 revert 진행	충돌 파일 수정 후 작업을 이어갈 때
--abort	진행 중 revert 취소	영향 범위가 예상과 다를 때

실무 적용 순서

1) 실행 전 상태 확인

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

2) 목적에 맞는 옵션 선택

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

3) 실행 후 검증

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

문제 상황 1개

상황: main에 배포 장애 커밋이 반영됐다.
원인: 핫픽스 검증 없이 머지된 커밋이 프로덕션 오류를 유발했다.
해결: git revert로 반대 변경 커밋을 생성해 빠르게 롤백하고 원인 커밋은 별도 브랜치에서 수정한다.
예방 팁: 보호 브랜치에 필수 리뷰와 체크 파이프라인을 강제한다.

참고/출처

공식 문서: git-revert manual
공식 문서: Pro Git - Advanced Merging
신뢰 자료: Atlassian - git revert