본문 바로가기

IT정보

Git merge rebase 차이, 언제 무엇을 쓸까? 충돌·되돌리기까지

반응형

작성일 2026년 11월 20일 · 기준: Git 공식 문서(git-scm.com)

핵심 답: merge는 두 브랜치를 합치면서 지금까지의 기록을 그대로 두고(필요하면 merge 커밋을 하나 만들어요), rebase는 내 커밋들을 다른 시작점 위로 옮겨 새 커밋으로 다시 만들어 기록을 한 줄로 정리해요. 혼자 쓰는 로컬 브랜치를 정리할 때는 rebase, 이미 push해서 다른 사람이 받은 커밋은 rebase하지 않는 것이 Git 공식 문서의 원칙이에요.

git merge rebase 차이

안녕하세요, 잇커니즘이에요. 코드 리뷰나 배포 회의에서 "그거 rebase 해서 올려 주세요", "merge 커밋 지저분하니까 squash 해 주세요" 같은 말이 오가면 개발자도, 같이 일하는 기획자도 헷갈리기 쉬워요. 이 글은 Git 공식 문서를 기준으로 merge와 rebase가 실제로 무엇을 하는지 → 현업에서 보통 어떻게 나눠 쓰는지 → 흔한 실수 → 되돌리는 방법 순서로 정리했어요.

Git merge와 rebase는 무엇이 다른가요?

먼저 용어 두 개만 정리할게요. 커밋은 코드 변경을 저장한 기록 한 칸이고, 브랜치는 그 기록 줄기에서 갈라져 나온 작업 공간이에요. 기능을 만들 때는 보통 main에서 feature 브랜치를 따서 작업한 뒤, 끝나면 다시 main에 합쳐요. 이때 합치는 방법이 merge와 rebase 두 가지예요.

merge는 두 브랜치의 마지막 커밋과 공통 조상 커밋, 이렇게 세 커밋을 비교하는 3-way merge로 결과를 만들고, 그 결과를 새 merge 커밋으로 남겨요. 원래 커밋은 하나도 바뀌지 않아요.

rebase는 두 브랜치가 갈라진 지점부터 내 브랜치의 변경 사항을 차례로 떼어 낸 뒤, 대상 브랜치의 최신 커밋 위에 하나씩 다시 적용해요. Git 공식 문서는 이를 "커밋들을 다른 시작점으로 옮겨 심는 것"이라고 설명해요. 내용은 같아도 새로 만든 커밋이라 커밋 해시(ID)가 바뀌어요.

# merge: main에 feature 브랜치를 합치기
git switch main
git merge feature

# rebase: feature 브랜치를 main 최신 커밋 위로 옮기기
git switch feature
git rebase main

git merge rebase 차이 비교

항목 merge rebase
기록 모양 갈라진 흔적이 그대로 남음, merge 커밋이 생길 수 있음 한 줄로 정리됨
기존 커밋 그대로 유지 새 커밋으로 다시 만듦(해시 변경)
충돌 해결 합칠 때 한 번에 커밋을 하나씩 적용하면서 여러 번 나올 수 있음
이미 push한 브랜치 안전 하지 않기(동료 기록과 꼬임)
도중에 취소 git merge --abort git rebase --abort
주로 쓰는 때 기능 브랜치를 main에 합칠 때 내 로컬 브랜치를 최신 main 기준으로 정리할 때

fast-forward 병합과 --no-ff는 언제 쓰나요?

main에 새 커밋이 없고 feature 브랜치만 앞으로 나아간 상태라면, Git은 merge 커밋을 만들지 않고 main 포인터만 feature 끝으로 옮겨요. 이것이 fast-forward이고, git merge의 기본 동작이에요.

반대로 --no-ff를 붙이면 fast-forward가 가능한 상황에서도 항상 merge 커밋을 만들어요. "이 기능이 언제 합쳐졌는지"를 기록에 남기고 싶은 팀이 자주 써요. --ff-only는 fast-forward가 안 되면 merge를 하지 않고 멈춰요.

rebase는 언제 쓰면 안 되나요?

Git 공식 책(Pro Git)은 rebase 주의사항을 한 문장으로 정리해요. "이미 공개 저장소에 Push 한 커밋을 Rebase 하지 마라." rebase는 커밋을 새로 만들기 때문에, 동료가 이미 받아 간 옛 커밋과 내가 다시 올린 새 커밋이 서로 다른 기록이 돼요. 그러면 동료는 다시 merge해야 하고, 같은 변경이 두 번 들어간 것처럼 기록이 엉켜요.

예를 들어 로그인 API 기능을 혼자 feature/login 브랜치에서 만들고 아직 push하지 않았다면, 마지막에 git rebase main으로 최신 main 위에 깔끔하게 올리는 건 괜찮아요. 하지만 이미 PR을 올려 동료가 그 브랜치를 받아 리뷰·수정 중이라면 rebase보다 git merge main으로 최신 내용을 받는 편이 안전해요.

git rebase 주의사항

rebase와 squash는 어떻게 다른가요?

squash는 여러 커밋을 하나로 합치는 것을 말해요. 방법은 두 가지예요.

  • git merge --squash feature: 실제로 merge한 것과 같은 작업 내용을 만들지만 커밋은 하지 않아요. 이어서 git commit을 직접 해야 하고, 결과는 merge 정보가 없는 일반 커밋 하나예요.
  • git rebase -i(대화형 rebase): 옮길 커밋 목록을 편집기로 보여 주고, 각 줄의 pick을 squash나 fixup으로 바꾸면 앞 커밋에 접어 넣어요. squash는 커밋 메시지를 합쳐서 제안하고, fixup은 접는 커밋의 메시지를 버려요.

즉 rebase는 "어디 위에 올릴지"를 바꾸는 것이고, squash는 "몇 개의 커밋으로 남길지"를 바꾸는 것이라 서로 다른 축이에요.

git pull --rebase는 일반 pull과 뭐가 다른가요?

git pull은 먼저 git fetch로 원격 변경을 받아 온 뒤, 그것을 현재 브랜치에 합쳐요. 합치는 방식에 따라 git pull --rebase는 rebase를, git pull --no-rebase는 merge를, git pull --ff-only는 fast-forward만 해요. 최신 git-pull 공식 문서에는 옵션을 정하지 않으면 fast-forward만 하는 것이 기본이라고 적혀 있으니, 사용하는 Git 버전의 문서를 함께 확인해 주세요. 내 로컬 커밋이 아직 push 전이라면 --rebase로 받으면 불필요한 merge 커밋 없이 기록이 한 줄로 유지돼요.

merge·rebase를 잘못했을 때 되돌리는 방법은?

  1. 충돌 해결 중에 그만두고 싶을 때: git merge --abort 또는 git rebase --abort. 시작 전 상태로 돌아가요. 단, merge를 시작할 때 커밋하지 않은 변경이 있었다면 완전히 복구되지 않을 수 있으니, 시작 전에 커밋하거나 stash해 두는 게 좋아요.
  2. rebase 중 충돌을 해결했을 때: 파일을 고치고 git add 한 뒤 git rebase --continue. 그 커밋을 건너뛰려면 git rebase --skip.
  3. merge 커밋을 이미 push했을 때: 기록을 지우지 말고 git revert -m 1 <merge 커밋>로 되돌리는 커밋을 새로 만들어요. -m 1은 "첫 번째 부모(보통 main 쪽)를 기준으로 되돌린다"는 뜻이에요.

⚠️ 주의: merge 커밋을 revert하면 Git은 "그 merge로 들어온 변경은 앞으로 원하지 않는다"고 기록해요. 그래서 나중에 같은 브랜치를 다시 merge해도 이전에 되돌린 변경은 다시 들어오지 않을 수 있어요(git-revert 공식 문서). 다시 넣어야 할 때는 revert 커밋을 한 번 더 revert하는 방법을 팀과 상의해 주세요.

git merge 되돌리기

흔한 실수와 바로 쓰는 체크리스트

  • ☐ rebase하려는 커밋을 이미 push했는지, 다른 사람이 그 브랜치를 쓰는지 확인했나요?
  • ☐ merge·rebase 전에 작업 중인 변경을 커밋하거나 stash했나요?
  • ☐ 팀 규칙(merge 커밋을 남길지, squash해서 합칠지, --no-ff를 쓸지)을 확인했나요?
  • ☐ 충돌이 나면 당황하지 말고 --abort로 처음 상태로 돌아갈 수 있다는 걸 기억했나요?
  • ☐ main처럼 여러 사람이 쓰는 브랜치에서는 rebase 대신 merge·revert로 처리하고 있나요?

자주 묻는 질문

Q. merge와 rebase 중 무엇이 더 좋은가요?
A. 정답은 없어요. Pro Git도 팀과 상황에 따라 판단하라고 하면서, 로컬 브랜치 정리에는 rebase를 쓸 수 있지만 push한 커밋은 rebase하지 말라고 정리해요.

Q. rebase하면 커밋 작성자가 바뀌나요?
A. 일반 rebase는 커밋 내용을 다시 적용할 뿐이에요. 대화형 rebase로 여러 사람의 커밋을 squash해 하나로 접으면, 접힌 커밋은 첫 번째 커밋의 작성자로 기록돼요.

Q. 개발자가 아닌데 꼭 알아야 하나요?
A. 자세한 명령까지는 몰라도 괜찮아요. "merge = 합친 흔적이 남음, rebase = 기록을 다시 씀" 정도만 알아도 배포·장애 회의에서 "그 기능이 언제 main에 들어갔나요?" 같은 질문을 정확하게 할 수 있어요.

Q. merge 커밋이 많으면 문제가 되나요?
A. 동작에는 문제가 없지만 기록을 읽기 어려워질 수 있어요. 그래서 팀마다 squash나 rebase로 정리한 뒤 합치는 규칙을 정해 두는 경우가 많아요.

함께 보면 좋은 글: CORS 오류 해결 방법, blocked by CORS policy 원인과 서버 설정 · HTTP 상태 코드 정리, 401과 403 차이부터 500 에러까지

출처

반응형