Git에서 마지막 N개 커밋을 squash하는 방법
2024-07-29
개요
Git에서 "squash"는 여러 개의 커밋을 하나로 합치는 것을 의미합니다. 이는 코드 리뷰를 간소화하거나, 히스토리를 깔끔하게 정리할 때 유용합니다. 특히, 마지막 N개의 커밋을 squash하면 최근 작업 내용을 하나의 논리적인 단위로 묶을 수 있습니다.
단계별 설명
Squash할 커밋 선택:
git log명령어를 사용하여 squash하려는 커밋들을 확인합니다.- squash하려는 커밋의 부모 해시값을 기록해둡니다.
Interactive Rebase 시작:
git rebase -i <부모 해시값>명령어를 실행합니다.- 이 명령어는 선택한 커밋부터 현재 브랜치의 최상위 커밋까지의 커밋들을 수정할 수 있는 인터랙티브 모드를 열어줍니다.
- 열린 텍스트 편집기에서 squash하려는 커밋 앞에
squash또는s를 입력합니다. - 나머지 커밋들은 그대로 두거나 필요에 따라 수정합니다.
- 열린 텍스트 편집기에서 squash하려는 커밋 앞에
Rebase 실행:
- 텍스트 편집기를 저장하고 닫으면 rebase가 실행됩니다.
- 충돌이 발생하면 충돌을 해결하고
git rebase --continue명령어를 실행합니다.
예시
마지막 3개의 커밋을 squash하려는 경우:
# squash할 커밋의 부모 해시값 확인
git log
# interactive rebase 시작
git rebase -i HEAD~3
# 텍스트 편집기에서 squash할 커밋 앞에 's' 입력
# 예:
pick f7e3051 first commit
pick 3104e03 second commit
squash 6dcb08b third commit
pick a11ef03 fourth commit
# 저장하고 닫으면 rebase 실행
주의사항
- Interactive Rebase는 위험할 수 있습니다. 잘못된 사용은 로컬 히스토리를 손상시킬 수 있으므로 주의해야 합니다.
- Remote 브랜치에 push하기 전에 항상 로컬 변경 사항을 commit하고 push해야 합니다.
- Squash는 커밋 히스토리를 변경하는 작업이므로 신중하게 결정해야 합니다.
추가 팁
- 커밋 메시지: squash된 커밋의 메시지는 첫 번째 커밋의 메시지로 합쳐집니다. 따라서 첫 번째 커밋의 메시지를 명확하게 작성하는 것이 중요합니다.
- 커밋 분할: 너무 많은 커밋을 한 번에 squash하는 것은 오히려 히스토리를 복잡하게 만들 수 있습니다. 논리적인 단위로 커밋을 분할하여 squash하는 것이 좋습니다.
- 커밋 취소: squash한 커밋을 다시 분리하려면
git reflog를 사용하여 이전 상태로 되돌릴 수 있습니다.
결론
Git에서 squash는 개발 과정에서 유용한 기능입니다. 하지만 잘못 사용하면 문제를 야기할 수 있으므로 명확하게 이해하고 신중하게 사용해야 합니다. 위에 설명된 단계를 따라하면 마지막 N개의 커밋을 쉽게 squash할 수 있습니다.
참고: 위 설명은 기본적인 squash 방법을 다루고 있습니다. 더 복잡한 경우에는 Git 문서를 참고하거나 전문가에게 문의하는 것이 좋습니다.
Git Squash 관련 샘플 코드 및 상세 설명
마지막 3개 커밋 squash하기
# 3개 커밋 이전 상태로 이동
git rebase -i HEAD~3
# 텍스트 편집기에서 squash할 커밋 앞에 's' 입력
# 예:
pick f7e3051 first commit
pick 3104e03 second commit
squash 6dcb08b third commit
pick a11ef03 fourth commit
# 저장하고 닫으면 rebase 실행
설명:
git rebase -i HEAD~3: 현재 커밋에서 3개 이전 커밋까지를 인터랙티브 모드로 재작업합니다.pick: 해당 커밋을 그대로 유지합니다.squash: 해당 커밋을 이전 커밋에 합칩니다.
특정 커밋 범위 squash하기
# 특정 커밋 해시 사용
git rebase -i <시작 커밋 해시>^ <끝 커밋 해시>
# 예:
git rebase -i f7e3051^ a11ef03
f7e3051^: f7e3051 커밋의 부모 커밋부터 시작합니다.a11ef03: a11ef03 커밋까지를 대상으로 합니다.
충돌 해결 후 rebase 계속하기
# 충돌 해결 후
git add .
git rebase --continue
git add .: 충돌을 해결하고 staging area에 추가합니다.git rebase --continue: rebase를 계속 진행합니다.
rebase 취소하기
# rebase 중단
git rebase --abort
git rebase --abort: rebase를 중단하고 이전 상태로 되돌립니다.
squash 후 커밋 메시지 편집하기
# squash된 커밋 메시지 편집
# (rebase 중 텍스트 편집기에서 직접 수정)
- squash된 커밋의 메시지는 첫 번째 커밋의 메시지로 합쳐집니다.
- rebase 중 텍스트 편집기에서 첫 번째 커밋의 메시지를 수정하여 최종 커밋 메시지를 결정합니다.
주의사항 및 추가 팁
- rebase는 위험할 수 있습니다. 특히 remote 브랜치에 push하기 전에 local에서 충분히 테스트해야 합니다.
- 커밋 메시지를 명확하게 작성하는 것이 중요합니다. squash된 커밋의 역사를 쉽게 파악할 수 있도록 도와줍니다.
- 너무 많은 커밋을 한 번에 squash하지 않는 것이 좋습니다. 논리적인 단위로 나누어 squash하는 것이 좋습니다.
- squash 후에는 히스토리가 변경되므로 주의해야 합니다.
- git reflog 명령어를 사용하여 이전 상태로 되돌릴 수 있습니다.
Git Squash의 대체 방법 및 각 방법의 장단점
Git Squash는 여러 개의 커밋을 하나로 합쳐 히스토리를 깔끔하게 정리하는 데 유용한 기능입니다. 하지만 모든 상황에서 Squash가 최선의 선택은 아닐 수 있습니다. Squash 외에도 Git 히스토리를 관리하는 다양한 방법들이 있습니다.
Merge
- 방법: 두 브랜치를 합칠 때, 각 브랜치의 모든 커밋을 새로운 커밋으로 병합합니다.
- 장점:
- 직관적이고 간단합니다.
- 모든 커밋이 히스토리에 남아 추적이 용이합니다.
- 단점:
- 히스토리가 복잡해질 수 있습니다.
- 특히 많은 기능 브랜치를 병합할 경우 히스토리가 복잡해져 관리가 어려울 수 있습니다.
Rebase and Merge
- 방법:
- 기능 브랜치를 main 브랜치에 rebase하여 히스토리를 선형화합니다.
- rebase된 브랜치를 main 브랜치에 merge합니다.
- 장점:
- 히스토리를 깔끔하게 유지할 수 있습니다.
- Squash와 비슷한 효과를 얻을 수 있습니다.
- 단점:
- rebase는 히스토리를 변경하는 작업이므로 주의해야 합니다.
- 특히 remote 브랜치에 push하기 전에 충분히 테스트해야 합니다.
Interactive Rebase
- 방법:
- 여러 개의 커밋을 선택하여 수정, 삭제, 합치는 등 다양한 작업을 수행할 수 있습니다.
- Squash 외에도 pick, reword, edit 등 다양한 명령어를 사용할 수 있습니다.
- 장점:
- 매우 유연한 방법입니다.
- 단점:
- 복잡하고 실수할 가능성이 높습니다.
- 잘못 사용하면 히스토리가 손상될 수 있습니다.
각 방법의 선택 기준
- 히스토리 관리: 깔끔한 히스토리를 원한다면 Squash나 Rebase and Merge를 고려합니다.
- 유연성: 다양한 작업을 수행하고 히스토리를 세밀하게 조정하고 싶다면 Interactive Rebase를 고려합니다.
- 팀 규약: 팀에서 정한 규약에 따라 방법을 선택해야 합니다.
결론
어떤 방법을 선택할지는 프로젝트의 특성, 팀의 규약, 개인의 선호도에 따라 달라집니다. 각 방법의 장단점을 충분히 이해하고 신중하게 선택해야 합니다.
예시 상황:
- 작은 기능 개발 후 main 브랜치에 병합: Squash 또는 Rebase and Merge
- 복잡한 기능 개발 후 히스토리 정리: Interactive Rebase
- 팀에서 히스토리 관리 규약이 정해진 경우: 팀 규약에 따라 선택
git rebase squash
