Git - cherry-pick

🍒 cherry-pick이란?

특정 브랜치에 있는 커밋 하나 또는 여러 개를 현재 브랜치로 "선택적으로" 복사해오는 Git 명령어.

• merge, rebase는 브랜치 단위로 히스토리를 합치는 방식이라면,
• cherry-pick은 특정 커밋만 골라 적용하는 방식

---

⚙️ 기본 사용법

git cherry-pick <커밋해시>

예: feature/login 브랜치에 있는 커밋을 main 브랜치에 가져오고 싶을 때

git checkout main
git cherry-pick 1a2b3c4

→ 해당 커밋이 main 브랜치에 새로운 커밋으로 복사됨.

---

🧪 실습 예시 (Windows 환경)

명령어는 Git Bash 또는 VS Code 터미널(cmd/powershell/git bash)에서 실행

✅ 1. 프로젝트 초기화

mkdir cherry-pick-demo && cd cherry-pick-demo
git init
echo Hello > file.txt
git add . && git commit -m "Initial commit"

✅ 2. 브랜치 생성 및 커밋 추가

git checkout -b feature
echo "Login feature" >> file.txt
git add . && git commit -m "Add login feature"

✅ 3. main으로 돌아가 cherry-pick 수행

git log --oneline # feature 브랜치에서 커밋 해시 확인 후

git checkout main
git cherry-pick <로그인 커밋 해시>

🔍 확인

cat file.txt

→ “Login feature” 내용이 main에도 추가되어 있음

 

🔍 확인2

git log --oneline  # 복사한 커밋은 해시값이 달라져있는것을 확인 가능

 

---

💡 실무에서 자주 쓰는 상황

✅ 1. 긴급 수정(Hotfix) 백포팅

git checkout release/1.0
git cherry-pick <bugfix-commit>

✅ 2. 특정 기능만 선별 적용

git checkout main
git cherry-pick <기능커밋1> <기능커밋2>

✅ 3. 외부 코드 재활용

git cherry-pick <다른브랜치-커밋>

✅ 4. 나중에 병합하려할때 충돌 주의

• 미리 복사 하여 적용시켰던 커밋이 브랜치 병합때 다시 들어가게 되면서 충돌이 발생할 수 있음

---

⚠️ cherry-pick 주의사항

• 커밋 내용은 같아도 새로운 해시가 생성됨 (복제 커밋)
• 충돌(conflict) 발생 시 수동 해결 필요
• 너무 자주 사용하면 히스토리 파악이 어려울 수 있음

git cherry-pick --continue  # 충돌 해결 후 진행

📌 여러 커밋 한번에

git cherry-pick 해시1 해시2

git cherry-pick A..B  # A 이후부터 B까지 (A는 포함되지 않음)

---

💥 cherry-pick 충돌 실습 예제 (Windows)

1. 초기화

mkdir cherry-conflict && cd cherry-conflict
git init
echo "Hello" > file.txt
git add . && git commit -m "init"

2. 브랜치 두 개 생성

git checkout -b feature-A
echo "Feature A line" >> file.txt
git add . && git commit -m "feat: add A"

git checkout main
git checkout -b feature-B
echo "Feature B line" >> file.txt
git add . && git commit -m "feat: add B"

3. cherry-pick (충돌 발생)

git switch feature-A
git log --oneline  # feat: add A 커밋 해시 복사
git switch main
git cherry-pick <<feature-A Hash>>

git switch feature-B
git log --oneline  # feat: add B 커밋 해시 복사

git checkout main
git cherry-pick <<feature-B Hash>>  # 충돌 발생

4. 충돌 확인 & 해결

cat file.txt
# 충돌 마커(<<<<, ====, >>>>)가 생김

# 수동으로 수정 후
git add file.txt
git cherry-pick --continue

 

---

✅ 마무리 정리

• cherry-pick은 특정 커밋만 필요한 브랜치로 선별 적용할 수 있는 강력한 도구
• 실무에서는 hotfix, 일부 기능만 적용, 커밋 재사용 등에 주로 활용됨
• 충돌이 날 수 있다는 점과 히스토리 관리에 주의가 필요함