git push --force-with-lease는 --force와 달리, 모르는 사이 원격에 올라온 커밋을 덮어쓰지 않으려고 쓰는 강제 push 옵션입니다. 그런데 기대 값 없이 쓰면 이 옵션은 원격 브랜치를 '내가 마지막으로 본 커밋'이 아니라 내 원격 추적 브랜치(origin/main)와 비교합니다. push 직전에 누군가 git fetch로 origin/main을 옮겨 놓으면, 동료가 올린 커밋은 --force를 쓴 것처럼 덮어써집니다. git 2.54.0으로 임시 원격 하나와 클론 둘을 만들어 push 방법을 바꿔 가며 돌린 결과입니다. 끝까지 읽으면 자기 환경에서 어떤 push 명령을 써야 동료 커밋이 지켜지는지 고를 수 있습니다.
실험 준비: 원격 하나, 클론 둘, 고쳐 쓴 커밋 하나
macOS 27.0.1의 git 2.54.0(Apple Git-157)으로 Mac 한 대에 bare 저장소 origin.git을 만들고 클론 두 개를 붙였습니다. 강제 push하는 쪽을 me, 동료 쪽을 mate라고 부릅니다. 그림과 출력의 '내 main'은 me 클론의 main입니다.
me가 base(bdeea2d)와 my work(9d6506f)를 push하고, 동료가 그 위에 teammate fix(6459d12)를 올렸습니다. 그사이 me는 이미 push한 9d6506f에 빠뜨린 테스트 파일을 넣으려고 git commit --amend를 했고, 그 결과가 98ccc0c입니다. 이제 내 main은 원격 main과 갈라졌으므로 강제 push 없이는 올라가지 않습니다.
이 순간 세 ref는 이렇게 서 있습니다. 원격 main은 동료의 6459d12, 내 origin/main은 me가 마지막으로 push할 때 맞춰진 9d6506f(그 뒤로 fetch는 하지 않았습니다), 내 main은 98ccc0c입니다. 경우마다 이 준비를 새로 만들었습니다. 개인 git 설정이 끼어들지 않도록 전역·시스템 설정을 읽지 않게 했고, 커밋 시각을 고정해 모든 경우에서 커밋 ID가 같습니다.
네 가지 push를 차례로 돌린 결과
![실제 실행 결과. 준비: remote main은 6459d12 teammate fix, me origin/main은 9d6506f my work, me main은 98ccc0c my work (rewritten). A: git push --force origin main은 + 6459d12...98ccc0c main -> main (forced update), exit 0, teammate fix on remote main: NO. B: git push --force-with-lease origin main은 ! [rejected] main -> main (stale info), error: failed to push some refs, exit 1, teammate fix: yes. C: git fetch origin이 9d6506f..6459d12 main -> origin/main을 찍고 me origin/main은 6459d12가 됐다. 이어서 git push --force-with-lease origin main은 forced update, exit 0, teammate fix: NO. D: 출력 없는 git fetch -q origin 뒤 git push --force-with-lease --force-if-includes origin main은 ! [rejected] main -> main (remote ref updated since checkout), exit 1, teammate fix: yes.](/images/ko/git-force-with-lease-fetch-run-01.png)
A. --force는 아무것도 확인하지 않고 forced update를 했습니다. 원격 main의 역사에서 6459d12가 빠졌습니다.
B. fetch 없이 --force-with-lease는 ! [rejected] main -> main (stale info)로 거부됐고 종료 코드는 1이었습니다. 원격 main(6459d12)이 내 origin/main(9d6506f)과 달랐기 때문입니다.
C. push 직전에 git fetch origin을 한 번 돌린 뒤 같은 --force-with-lease를 쓰자 이번에는 forced update로 통과했고, 6459d12는 다시 원격 main에서 빠졌습니다. 동료 커밋을 열어 보지도, 내 브랜치에 합치지도 않았습니다. 내 브랜치는 그대로이고, 세 ref 중에서 옮겨진 것은 origin/main 하나뿐입니다.
D. 같은 fetch 뒤 --force-with-lease --force-if-includes는 (remote ref updated since checkout)으로 거부됐습니다. 동료 커밋은 원격에 남았습니다.
fetch 한 번에 보호가 사라지는 이유
기대 값 없이 쓴 --force-with-lease는 원격 ref의 현재 값이 내 원격 추적 브랜치와 같을 때만 덮어씁니다. git에는 '사람이 무엇을 봤는지'를 따로 적어 둔 기록이 없어서 origin/main을 그 대신으로 씁니다. 그런데 git fetch는 내 브랜치는 건드리지 않고 원격 추적 브랜치(여기서는 origin/main)만 원격 값으로 옮깁니다. fetch가 끝난 직후에는 원격과 origin/main이 같으니, lease는 동료 커밋을 이미 본 것으로 여기고 통과시킵니다.
git-push 문서도 이 점을 경고합니다. 백그라운드에서 ref를 갱신하는 프로세스가 있으면 이 보호가 “trivially defeated”, 곧 손쉽게 무력화된다고 적고, cron으로 돌리는 git fetch origin과 편집기가 백그라운드에서 돌리는 fetch를 예로 듭니다. 이 실험은 편집기의 자동 fetch를 켜지 않고 push 직전의 수동 git fetch로 같은 상황을 흉내 냈습니다.
개발 노트
lease가 보는 것은 원격과 내 origin/main
push 직전 세 ref의 위치와 결과(커밋 ID는 실제 실행 값)
준비: 동료가 먼저 push했다
- 원격 main → 6459d12 teammate fix
- 내 origin/main → 9d6506f my work
- 내 main → 98ccc0c my work (rewritten)
- 동료 커밋은 9d6506f 위에 쌓였다
B: fetch 없이 --force-with-lease
6459d12 != 9d6506f- 원격 6459d12와 origin/main 9d6506f가 다름
- lease가 깨져 stale info로 거부
- 동료 커밋이 원격 main에 남음
C: git fetch 뒤 --force-with-lease
6459d12 == 6459d12- fetch가 origin/main만 6459d12로 옮김
- 내 main은 그대로 98ccc0c
- 원격과 origin/main이 같아 lease 통과
- forced update, 동료 커밋이 원격 main에서 빠짐
D: fetch 뒤 --force-if-includes까지
--force-if-includes- 내 main의 reflog: 98ccc0c, 9d6506f, bdeea2d
- 어느 기록에서도 6459d12에 닿지 않음
- remote ref updated since checkout으로 거부
- 동료 커밋이 원격 main에 남음
2026-11-09 macOS 27.0.1의 git 2.54.0(Apple Git-157)에서 직접 돌렸고 2026-11-10 다시 돌려 같은 값을 얻었다. 경우마다 같은 준비를 새로 만들었고 커밋 시각을 고정해 ID가 같다. D의 reflog는 2026-11-10 같은 준비를 다시 만들어 git reflog main으로 찍었다. 백그라운드 fetch는 수동 git fetch로 흉내 냈다.
--force-if-includes는 질문을 하나 더 합니다. 원격 추적 브랜치의 끝 커밋(여기서는 6459d12)이 내 로컬 브랜치 reflog의 기록 중 하나에서 닿는가입니다. D와 같은 순서를 다시 돌려 push 직전에 git reflog main을 찍어 보니 기록은 98ccc0c, 9d6506f, bdeea2d 셋뿐이었고, 어느 것에서도 6459d12에 닿지 않습니다. 받아 오기만 하고 합치지 않은 커밋이 있다는 뜻이어서 git은 push를 거부했습니다.
이 옵션은 기대 값 없는 --force-with-lease와 함께 쓸 때만 검사를 하고, lease 없이 쓰거나 기대 값을 적은 lease와 함께 쓰면 아무 일도 하지 않습니다(no-op). 따로 돌린 G1에서도 --force --force-if-includes는 검사 없이 forced update를 해 동료 커밋을 지웠습니다.
동료 커밋을 지키는 세 가지 방법
![실제 실행 결과. E: expected = 9d6506f(my work, 내가 push했다가 고쳐 쓴 커밋). git fetch -q origin 뒤 git push --force-with-lease=main:9d6506f origin main은 ! [rejected] main -> main (stale info), exit 1, teammate fix: yes. F: git fetch -q origin, git rebase origin/main은 Successfully rebased and updated refs/heads/main. 이어서 git push --force-with-lease --force-if-includes origin main은 6459d12..3b77748 main -> main, exit 0, teammate fix: yes, remote log는 3b77748 my work (rewritten) < 6459d12 teammate fix < 9d6506f my work < bdeea2d base. G3: git fetch -q origin, git reset --hard origin/main(HEAD is now at 6459d12 teammate fix), git reset --hard 98ccc0c(HEAD is now at 98ccc0c my work (rewritten)). main의 reflog는 98ccc0c reset: moving to 98ccc0c, 6459d12 reset: moving to origin/main, 98ccc0c commit (amend), 9d6506f commit: my work, bdeea2d commit (initial): base. git push --force-with-lease --force-if-includes origin main은 forced update, exit 0, teammate fix: NO.](/images/ko/git-force-with-lease-fetch-run-02.png)
기대 커밋을 직접 적습니다. --force-with-lease=main:9d6506f는 origin/main이 지금 어디를 가리키든 원격 main이 9d6506f일 때만 덮어쓴다는 뜻입니다. E에서는 push 직전에 fetch를 했는데도 원격 main이 6459d12라서 stale info로 거부됐습니다. 기대 값은 push하는 쪽이 원격 main에 마지막으로 있다고 알고 있던 커밋, 여기서는 me 클론이 push했다가 amend로 고쳐 쓴 9d6506f입니다. 고쳐 쓰기 전에 git tag before-amend main으로 그 커밋(9d6506f)에 태그를 달아 두고 --force-with-lease=main:before-amend로 쓰는 방법도 있습니다(태그 형태는 이번에 돌리지 않았습니다). 기대 값을 직접 적는 형태를 뺀 나머지 형태는 git 2.54.0에서도 실험적 기능으로 남아 있어 동작이 바뀔 수 있습니다.
받은 커밋을 먼저 합칩니다. fetch 뒤 git log --oneline main..origin/main을 보면 6459d12 teammate fix와 고쳐 쓰기 전의 9d6506f my work 두 줄이 나왔습니다. F에서 git rebase origin/main으로 내 커밋을 6459d12 위에 다시 올린 뒤에는, 안전장치 두 개를 그대로 붙인 push가 6459d12..3b77748 빨리 감기(fast-forward)로 통과했습니다. 동료 커밋은 남았습니다. 다만 동료 커밋이 9d6506f 위에 쌓여 있으므로 고쳐 쓰기 전의 9d6506f도 역사에 남았고, 다시 올린 3b77748은 빠뜨렸던 test.txt 한 파일만 더했습니다.
9d6506f까지 역사에서 빼려면 그 위에 쌓인 동료 커밋도 다시 써야 합니다. 따로 돌린 git rebase --onto 98ccc0c 9d6506f origin/main은 동료의 fix.txt 변경을 그대로 두고 커밋 ID를 6459d12에서 7a17afd로 바꿨고, 결과는 main이 아니라 detached HEAD에 남았습니다. git switch -C main으로 main을 그 결과로 옮겨 안전장치 두 개로 push하자, main의 reflog 어느 기록에서도 6459d12에 닿지 않아 remote ref updated since checkout으로 거부됐습니다. 기대 값을 적은 --force-with-lease=main:6459d12로는 forced update로 통과했지만, 원격 main에서 6459d12가 빠지고 7a17afd가 그 자리에 올라갔습니다. 동료 클론은 fetch 뒤 [ahead 2, behind 2]로 갈라져, 동료도 클론을 다시 맞춰야 합니다.
설정으로 기본값을 바꿉니다. G2에서 git config push.useForceIfIncludes true를 켠 뒤 C와 같은 순서로 --force-with-lease만 쓰자, D와 같은 remote ref updated since checkout으로 거부됐습니다. --force-if-includes와 push.useForceIfIncludes는 Git 2.30.0에서 들어왔습니다(이 글의 실행은 2.54.0). 그보다 오래된 git은 둘 다 모르며, 설정은 오류 없이 무시될 수 있으니(옛 git은 돌려 보지 않았습니다) git --version부터 확인하십시오.
남은 맹점: --force-if-includes도 reflog만 본다
--force-if-includes가 확인하는 것은 '지금 내 브랜치에 동료 커밋이 들어 있는가'가 아니라 'reflog 기록 중 하나에서 그 커밋에 닿는가'입니다. 추가로 돌린 G3에서는 fetch 뒤 git reset --hard origin/main으로 한 번 동료 커밋으로 옮겼다가 곧바로 git reset --hard 98ccc0c로 되돌렸습니다. 내 main에는 동료 커밋이 없지만 reflog에 6459d12가 남았고, push는 forced update로 통과해 동료 커밋이 원격 main에서 빠졌습니다. 받은 커밋을 합쳤다가 대화형 rebase에서 떨어뜨리는 경우도 같은 구조로 보이지만, 그 경우는 돌려 보지 않았습니다.
덮어쓴 커밋은 어디에 남나
A 뒤 원격 main의 역사는 98ccc0c와 bdeea2d뿐이었고, 6459d12 커밋 객체는 origin.git 안에 남았지만(git cat-file -t가 commit) 어느 ref에서도 닿지 않았습니다. bare 저장소는 기본으로 reflog를 남기지 않아 origin.git에는 reflog 폴더도 없었습니다. 이 실험에서 6459d12를 브랜치로 온전히 가진 곳은 동료의 클론뿐이었습니다. GitHub 같은 호스팅 서비스의 복구 기능은 확인하지 않았습니다.
강제 push에 붙일 것, 거부된 뒤 할 것
편집기나 다른 도구가 백그라운드에서 fetch를 돌릴 수 있는 환경이라면 강제 push에는 --force-with-lease --force-if-includes를 함께 붙이십시오. 거부되면 git fetch origin으로 받은 뒤 git log main..origin/main으로 받은 커밋을 확인하고, rebase로 합친 다음 다시 push하면 됩니다. fetch를 건너뛰면 B처럼 origin/main이 옛 값에 머물러 이 목록에 동료 커밋이 나오지 않습니다. 목록에 고쳐 쓰기 전의 내 커밋도 있으면 F의 9d6506f처럼 역사에 다시 남습니다. 동료 커밋이 그 위에 쌓였기 때문이고, 빼려면 동료 커밋까지 다시 써야 하니 동료와 먼저 맞추십시오.
amend가 이미 push한 파일을 고쳤다면 rebase가 고쳐 쓰기 전 내 커밋과 충돌할 수 있습니다(이 실험의 amend는 새 파일만 더해 F에서 충돌이 없었습니다). 내 옛 줄은 고친 쪽으로 바꾸되, 동료가 같은 파일에서 고친 줄은 지우지 말고 함께 남기십시오. rebase가 멈춘 상태에서 git log --oneline main..origin/main -- <파일>에 내 옛 커밋 말고 동료 커밋도 나오면 동료가 그 파일을 고친 경우입니다. 따로 돌린 실행에서는 준비를 바꿔, 이미 push한 my.txt의 줄을 amend로 고치고 동료 커밋은 같은 파일에 한 줄을 더했습니다. 충돌의 HEAD 쪽에 내 옛 줄과 동료 줄이 함께 들어 있었고, 고친 쪽만 남기자 동료 줄이 사라진 채 두 안전장치를 붙인 push가 빨리 감기로 통과했습니다.
이 기록에 대화를 더해 주세요.
궁금한 점, 다른 접근, 직접 해 본 결과를 나눠 주세요.
로그인 상태 확인 중…
댓글을 불러오는 중…