환경  Git 2.54 에서 재현 · 2026-11-09 확인

출근해서 커피를 내려놓고 습관처럼 git pull 을 칩니다. 어제 저녁에 커밋 하나를 남겨 뒀고, 밤사이 동료도 같은 브랜치에 커밋을 올렸습니다. 화면에는 hint 열두 줄이 지나가고 마지막 줄에 fatal 이 찍힙니다. 원격 커밋은 받아 왔지만 내 브랜치에 합치지 못한 것이고, 망가진 것은 없습니다. 이 멈춤이 무슨 뜻인지, 그다음에 무엇을 고르면 되는지 차례로 짚어 봅니다.

어제까지 잘 되던 pull 이 왜 갑자기 fatal 을 내나요?

pull 은 두 단계로 움직입니다. 먼저 fetch 로 원격의 새 커밋을 받아 origin/main 을 옮기고, 그다음 그 커밋을 내 브랜치에 합칩니다. 멈춘 건 두 번째 단계입니다. 첫 줄의 681ec9e..ce5740b 같은 표시가 보이면 fetch 는 이미 끝났다는 뜻입니다.

어제까지는 내 쪽에 새 커밋이 없었을 겁니다. 그러면 원격 커밋을 그대로 이어 붙이기만 하면 되니 고를 게 없습니다. 이걸 fast-forward 라고 부릅니다. 오늘은 사정이 다릅니다. 내 커밋 하나와 동료의 커밋 하나가 같은 부모에서 갈라져 있습니다. 이걸 하나로 합치는 방법이 merge 와 rebase 두 가지인데, 어느 쪽을 쓸지 설정이 비어 있으니 Git 이 손을 떼고 물어보는 겁니다.

그래서 이 fatal 은 고장이 아니라 질문입니다. 작업트리도 커밋도 그대로입니다. git status -sb 를 쳐 보면 ahead 1, behind 1 처럼 양쪽에 하나씩 쌓여 있는 게 보입니다.

git pull
# hint: You have divergent branches and need to specify how to reconcile them.
# ...
# fatal: Need to specify how to reconcile divergent branches.

# 받아 온 건 이미 받아져 있다. 양쪽이 얼마나 갈라졌는지만 본다
git status -sb
# ## main...origin/main [ahead 1, behind 1]
git log --oneline --graph main origin/main

fetch 는 끝났고, 합치는 방법만 정해지지 않은 상태입니다

이 fatal 은 고장이 아니라 merge 와 rebase 중 무엇을 할지 묻는 질문입니다.

hint 에 나온 세 줄 중 무엇을 고르면 되나요?

hint 는 pull.rebase false, pull.rebase true, pull.ff only 세 가지를 보여 줍니다. 각각 merge, rebase, 그리고 갈라졌으면 그냥 멈추기입니다.

pull.rebase false 를 고르면 동료 커밋과 내 커밋을 묶는 머지 커밋이 하나 생깁니다. 기록이 실제로 일어난 순서 그대로 남는 대신, 하루에 여러 번 pull 하는 팀이라면 'Merge branch main of ...' 커밋이 로그를 덮습니다. pull.rebase true 는 내 커밋을 떼어 내 동료 커밋 뒤에 다시 얹습니다. 로그는 한 줄로 깔끔해지지만 내 커밋의 해시가 바뀝니다.

혼자 쓰는 브랜치거나, 아직 push 하지 않은 내 커밋만 옮기는 상황이라면 rebase 가 무난합니다. 이미 남에게 보낸 커밋을 rebase 로 다시 쓰면 그 사람 쪽 기록과 어긋나니 그럴 땐 merge 가 맞습니다. 어느 쪽이 정답이라기보다 팀이 로그를 어떻게 읽고 싶은지의 문제라서, 저장소마다 정해 두는 편이 낫습니다.

# 이 저장소만
git config pull.rebase true

# 내 모든 저장소의 기본값
git config --global pull.rebase true

# 설정은 그대로 두고 이번 한 번만 고르기
git pull --rebase
git pull --no-rebase

설정은 기본값, 명령줄 옵션은 그 한 번만입니다

pull.ff only 는 아무것도 안 해 주는데 왜 고르나요?

맞습니다. pull.ff only 를 걸어 두면 오늘 같은 상황에서 pull 은 여전히 멈춥니다. 메시지만 'Not possible to fast-forward, aborting.' 으로 바뀌고, git merge --no-ff 나 git rebase 를 직접 하라고 안내합니다.

이 설정은 pull 이 몰래 머지 커밋을 만들거나 내 커밋을 다시 쓰지 못하게 막는 안전장치입니다. 서버에 배포용으로 받아 둔 체크아웃처럼 로컬에서 커밋할 일이 없어야 하는 곳에 잘 맞습니다. 거기서 갈라졌다는 건 누군가 서버에서 직접 커밋을 했다는 신호니까, 자동으로 합쳐 버리는 것보다 멈춰서 알려 주는 쪽이 낫습니다.

최근 Git 문서는 아무 설정이 없을 때의 기본 동작을 --ff-only 로 적고 있습니다. 그러니 pull.ff only 를 명시하는 건 hint 를 끄고 지금 동작을 굳히는 일에 가깝습니다.

git config pull.ff only
git pull
# hint: Diverging branches can't be fast-forwarded, you need to either:
# hint: 	git merge --no-ff
# hint: or:
# hint: 	git rebase
# fatal: Not possible to fast-forward, aborting.

배포용 체크아웃에는 이 설정이 어울립니다

pull.rebase true 와 pull.ff only 를 같이 걸어 두면 어떻게 되나요?

둘 다 켜 두면 rebase 로 알아서 합쳐 주고, 합칠 게 없을 땐 fast-forward 만 하겠지 하고 기대하기 쉽습니다. Git 2.54 에서 두 값을 같이 두고 갈라진 상태에서 pull 을 하면 그렇게 되지 않습니다. pull.ff only 쪽이 이기고 'Not possible to fast-forward' 로 멈춥니다.

명령줄에서 --rebase 를 직접 주면 얘기가 달라집니다. 같은 저장소에서 git pull --rebase 는 문제없이 내 커밋을 다시 얹고, git pull --no-rebase 는 머지 커밋을 만듭니다. 설정 두 개가 부딪힐 때와 명령줄이 설정을 덮을 때의 결과가 다른 셈입니다.

그러니 설정은 하나만 고르는 게 헷갈리지 않습니다. 평소엔 rebase 를 쓰고 싶다면 pull.rebase true 만 두고 pull.ff 는 비워 둡니다. 멈추는 게 목적이라면 pull.ff only 만 둡니다. 어디서 무엇이 걸려 있는지는 git config --show-origin 으로 한 번에 보입니다.

# 어떤 파일에 어떤 값이 걸려 있는지
git config --show-origin --get-regexp '^pull\.'

# 하나만 남기기
git config --unset pull.ff
git config --global --unset pull.ff

pull 설정은 전역·저장소 양쪽에 숨어 있기 쉽습니다

pull.rebase 와 pull.ff only 를 같이 두면 rebase 를 기대해도 멈춥니다. 하나만 고릅니다.

작업 중인 파일이 있는데 rebase 로 pull 하면 거절당해요

커밋하지 않은 수정이 있으면 git pull --rebase 는 'cannot pull with rebase: You have unstaged changes.' 를 내고 바로 멈춥니다. rebase 는 작업트리가 깨끗해야 시작합니다.

--autostash 를 붙이면 Git 이 그 수정을 임시로 stash 해 두고, rebase 를 마친 뒤 다시 꺼내 줍니다. 화면에 'Created autostash' 와 'Applied autostash' 가 차례로 찍히고, 끝나면 수정 파일이 그대로 M 상태로 남아 있습니다. 매번 붙이기 번거로우면 rebase.autoStash 를 true 로 둡니다. 이 값의 기본은 false 입니다.

다만 마지막에 stash 를 다시 얹다가 충돌이 날 수 있습니다. 동료가 바꾼 줄과 내가 고치던 줄이 겹치면 그렇습니다. 이때 stash 는 지워지지 않고 남으니 git stash list 로 확인하고 손으로 정리하면 됩니다.

git pull --rebase
# error: cannot pull with rebase: You have unstaged changes.

git pull --rebase --autostash
# Created autostash: 5ee892d
# Applied autostash.

# 늘 이렇게 하고 싶다면
git config rebase.autoStash true

autostash 는 잠깐 치워 뒀다 다시 얹는 것뿐, 충돌까지 막아 주지는 않습니다

pull 하고 나서 결과가 마음에 안 들면 어떻게 되돌리나요?

충돌이 나서 중간에 멈췄다면 간단합니다. rebase 중이면 git rebase --abort, merge 중이면 git merge --abort 로 pull 하기 전 상태로 돌아갑니다. 손댄 것 없이 물러나는 길이 따로 마련돼 있습니다.

이미 끝났는데 머지 커밋이 생긴 게 싫거나 rebase 결과가 이상하다면 ORIG_HEAD 를 봅니다. pull 이 내 브랜치를 옮기기 직전 위치를 Git 이 여기에 남겨 둡니다. git log ORIG_HEAD 로 그때 모습이 맞는지 먼저 보고, 맞으면 reset 으로 돌아갑니다. 시간이 좀 지나 다른 명령을 여러 번 친 뒤라면 ORIG_HEAD 가 덮였을 수 있으니 git reflog 에서 pull 직전 줄을 찾습니다.

reset --hard 는 작업트리의 커밋하지 않은 수정까지 지웁니다. 되돌리기 전에 git status 로 남은 수정이 없는지 확인하는 순서는 건너뛰지 않습니다.

# 충돌로 멈췄을 때
git rebase --abort      # 또는 git merge --abort

# 끝난 pull 을 되돌릴 때
git status              # 남은 수정이 없는지 먼저
git log --oneline -3 ORIG_HEAD
git reset --hard ORIG_HEAD

# ORIG_HEAD 가 덮였다면
git reflog -10

되돌리기 전에 ORIG_HEAD 가 정말 pull 직전인지 눈으로 봅니다

조치 후 확인할 것

  • pull 이 fatal 로 멈추면 git status -sb 로 ahead/behind 를 먼저 보고, 받아 온 것은 이미 origin/ 쪽에 있다는 걸 기억한다
  • 저장소마다 pull.rebase true·false·pull.ff only 중 하나만 정하고, git config --show-origin --get-regexp '^pull\.' 로 겹친 설정이 없는지 본다
  • 배포용 체크아웃처럼 로컬 커밋이 없어야 하는 곳은 pull.ff only 로 둔다
  • 커밋 안 한 수정이 있으면 --autostash 를 쓰고, 끝난 뒤 git stash list 가 비었는지 확인한다
  • 결과가 이상하면 --abort 또는 ORIG_HEAD 로 되돌리되, reset --hard 전에 남은 수정부터 확인한다

git pull 이 멈추는 순간은 대개 내 커밋과 남의 커밋이 처음으로 마주치는 순간입니다. Git 은 그 둘을 어떻게 묶을지 대신 정하지 않고 묻습니다. 한 번 답해 두면 다시 묻지 않으니, 저장소를 처음 받을 때 merge 로 갈지 rebase 로 갈지, 아니면 아예 멈추게 할지를 정해 두는 것만으로 아침의 fatal 한 줄은 대부분 사라집니다.