git rebase 이력 깔끔하게 정리: 충돌 복구와 interactive rebase 실전

git rebase 이력 깔끔하게 정리: 충돌 복구와 interactive rebase 실전

git rebase는 기능 브랜치를 최신 기준으로 재정렬해 리뷰 가독성을 높여준다. 단, 공유 브랜치에 무분별하게 사용하면 협업 사고가 생길 수 있다.

리베이스 개념도 (출처: Pro Git, git-scm.com)

기본 사용법

git switch feature/search-api
git rebase main

자주 쓰는 옵션 5가지

항목	의미	언제 쓰는지(실무 상황)
-i	interactive rebase	커밋 순서/메시지/스쿼시 정리가 필요할 때
--continue	충돌 해결 후 진행	충돌 파일 수정 완료 후 다음 단계로 갈 때
--abort	리베이스 중단	충돌이 과도해 전략을 바꿔야 할 때
--skip	현재 커밋 건너뜀	중복 반영된 커밋이 있을 때
--autosquash	fixup/squash 자동 정렬	리뷰 반영 커밋을 정돈할 때

문제 상황

상황: rebase 후 원격 푸시가 거절되고 동료 브랜치와 충돌한다.
원인: 공유 이력을 재작성했는데 강제 푸시 정책을 고려하지 않았다.
해결: 팀 합의된 브랜치에서만 rebase하고 필요 시 --force-with-lease로 안전하게 갱신한다.
예방 팁: main/shared 브랜치에는 rebase 대신 merge 정책을 유지한다.

참고/출처

공식 문서: git-rebase manual
공식 문서: Pro Git - Rebasing
신뢰 자료: Atlassian - git rebase