git cherry-pick으로 핫픽스 이식하기: 특정 커밋만 선택 반영하는 실무법

git cherry-pick으로 핫픽스 이식하기: 특정 커밋만 선택 반영하는 실무법

git cherry-pick은 전체 브랜치를 머지하지 않고 필요한 커밋만 선택 반영할 때 쓰인다. 릴리스 브랜치 핫픽스 백포트에서 특히 자주 사용된다. 초보~중급 개발자가 바로 적용할 수 있도록 명령어 흐름, 옵션 선택 기준, 복구 절차를 실무 중심으로 설명한다.

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

git cherry-pick 기본 사용 패턴

git switch release/1.4
git cherry-pick -x a1b2c3d
git push origin release/1.4

자주 쓰는 옵션 3~6개

항목	의미	언제 쓰는지(실무 상황)
-x	원본 커밋 해시를 메시지에 기록	감사 추적이 필요한 운영 브랜치 반영 시
--no-commit	커밋 없이 변경만 적용	여러 커밋을 묶어서 정리할 때
--continue	충돌 해결 후 진행	충돌 수정 완료 후 이어갈 때
--abort	진행 취소	영향 범위가 커서 전략을 바꿀 때
A..B	커밋 범위 선택 적용	연속된 수정 묶음을 이식할 때

실무 적용 순서

1) 실행 전 상태 확인

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

2) 목적에 맞는 옵션 선택

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

3) 실행 후 검증

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

문제 상황 1개

상황: feature 브랜치 전체를 머지하면 불필요한 변경이 같이 들어간다.
원인: 핫픽스 커밋만 필요한데 merge를 사용했다.
해결: cherry-pick으로 필요한 커밋만 선택 반영하고 테스트 범위를 제한한다.
예방 팁: 핫픽스 커밋은 작은 단위로 분리해 cherry-pick 가능성을 높인다.

참고/출처

공식 문서: git-cherry-pick manual
공식 문서: Pro Git - Revision Selection
신뢰 자료: Atlassian - cherry-pick