git worktree 병렬 작업 중 커밋이 사라졌다 — linked worktree가 공유하는 stash·ref·gc
목차
1. 한 저장소에 작업 공간 두 개
네온보드는 휴대폰과 태블릿을 LED 전광판으로 바꿔 주는 Flutter 앱입니다. 2026년 10월 15일, 이 저장소에는 작업마다 worktree가 여럿 붙어 있었고, 이 글의 중심은 그중 두 작업입니다. 하나는 곧 낼 2.1 버전의 리뷰 지적을 고치는 일, 다른 하나는 2.2로 잡아 둔 플랫폼 이행이었습니다. Flutter 3.47.7, flutter_riverpod 3.4.3, go_router 17.5.0으로 올리고 hive를 hive_ce 2.20.2로 바꾸는 일로, 2.0 아키텍처 편에서 들인 Riverpod·Hive·GoRouter를 한 세대씩 올리는 셈이었습니다. 이 2.2 작업은 같은 날 오전 3.0 출시 라인에 합쳐졌습니다.
서로 기다릴 이유가 없는 작업이라 저장소를 하나 더 클론하는 대신 git worktree를 썼습니다. git worktree add로 작업 디렉터리를 하나 더 붙이면 객체 저장소를 함께 쓰므로 디스크를 덜 쓰고, 한쪽 커밋을 다른 쪽에서 바로 병합할 수 있습니다. 메인 작업 공간(neon_board)은 feature/neonboard-2.x 브랜치로 2.1 리뷰 반영을, linked worktree(neon_board-22)는 그날 06:01:14에 850b965에서 갈라진 feature/2.2-modernize 브랜치로 2.2 이행을 맡았습니다.
두 작업은 동시에 진행했습니다. 폴더도 브랜치도 다르니 서로 간섭할 일은 없다고 생각했는데, 그 생각은 절반만 맞았습니다.
2. 커밋 하나가 reflog에도 없이 사라졌다
두 브랜치의 reflog를 시간순으로 섞어 보면 문제의 시간대가 이렇게 보입니다. 아래는 실제 네온보드 저장소에서 읽기 명령으로 뽑은 출력입니다.
$ for b in feature/neonboard-2.x feature/2.2-modernize; do
> git log -g --date=format:'%m-%d %H:%M:%S' --format='%gd %h %<(48,trunc)%gs' "$b"
> done | grep -E '\{10-15 (07:[3-5]|08:[0-2])' | sort -t'{' -k2
feature/neonboard-2.x@{10-15 07:34:55} a14db3a commit: fix: 2.1 리뷰 R1 - 광고·전광판 종료·AT..
feature/2.2-modernize@{10-15 07:42:34} ed862cf commit: chore: hive_ce_generator로 어댑터 재생성
feature/2.2-modernize@{10-15 07:49:12} b0249a4 commit: fix: 꼬리 잘림 판정 강화, 손상 복구를 ..
feature/2.2-modernize@{10-15 07:51:46} 72da6d5 commit: fix: 저장 중 자동 compaction 끄기, 안전..
feature/2.2-modernize@{10-15 07:51:58} ea58eac commit (amend): fix: 저장 중 자동 compaction 끄..
feature/2.2-modernize@{10-15 07:53:35} 134a135 commit: fix: 백업 사본을 만든 순서대로 보존(시..
feature/2.2-modernize@{10-15 07:54:56} d46ccd4 commit: chore: wakelock_plus 1.8.1, package_in..
feature/2.2-modernize@{10-15 08:03:44} 6a8477e commit: feat: 색상 선택기를 flex_color_picker ..
feature/2.2-modernize@{10-15 08:06:58} cdcf808 commit: chore: iOS 자동 이행(Flutter 3.47.7 첫..
feature/2.2-modernize@{10-15 08:09:21} 3c30d05 commit: chore: iOS CocoaPods 제거, GMA 빌드 회..
feature/neonboard-2.x@{10-15 08:14:28} d9fd9f1 commit: fix: 2.1 리뷰 R3 - 카피 통일과 접근성(..
feature/2.2-modernize@{10-15 08:18:00} a512d8e commit: chore: 2.2.0+11, README를 Flutter 3.47..
feature/neonboard-2.x@{10-15 08:19:06} 129d59a split R3 commit back into behavior and copy/a11y
feature/neonboard-2.x@{10-15 08:24:51} 0b853c1 commit: fix: 2.1 마무리 - 꼬리 잘림으로 빈 전광..메인 작업 공간 쪽을 보면, 07:34:55에 2.1 리뷰 1차(R1) 반영 커밋 a14db3a가 올라갑니다. 3차(R3) 반영은 동작(홈·에디터·설정) 커밋과 문구·접근성 커밋, 두 개로 올라갈 예정이었습니다. 그런데 브랜치에 남은 것은 08:14:28의 d9fd9f1 하나뿐입니다. 그날 적어 둔 사라진 커밋의 해시 025f1f0은 브랜치에도, 브랜치 reflog에도, 메인 작업 공간의 HEAD reflog에도 없습니다. 그사이 약 40분 동안 2.2 브랜치에는 reflog 항목이 아홉 줄(amend 포함) 쌓였습니다.
변경 내용은 사라지지 않았습니다. 동작 수정은 스테이징 영역에 남아 있다가 다음 커밋 d9fd9f1에 쓸려 들어가, 메시지는 '카피 통일과 접근성'인데 동작 수정까지 든 커밋이 됐습니다. 메인 작업 공간에서 이를 알아채고 4분 38초 뒤 커밋을 다시 둘로 나눴습니다. 08:19:06의 'split R3 commit back into behavior and copy/a11y'가 그 기록이고, 나눈 결과는 숫자로 검증할 수 있습니다.
$ git log --no-walk=unsorted --shortstat \
> --format='%h parent=%p tree=%t %<(34,trunc)%s' d9fd9f1 50fcff2 129d59a
d9fd9f1 parent=a14db3a tree=ca15663 fix: 2.1 리뷰 R3 - 카피 통일과 접..
41 files changed, 2370 insertions(+), 498 deletions(-)
50fcff2 parent=a14db3a tree=b39102d fix: 2.1 리뷰 R3 - 홈·에디터·설정..
32 files changed, 1711 insertions(+), 212 deletions(-)
129d59a parent=50fcff2 tree=ca15663 fix: 2.1 리뷰 R3 - 카피 통일과 접..
17 files changed, 659 insertions(+), 286 deletions(-)다시 만든 동작 커밋 50fcff2(+1,711/−212줄)와 문구·접근성 커밋 129d59a(+659/−286줄)를 더하면 d9fd9f1의 +2,370/−498줄과 정확히 맞습니다(파일 수는 겹치는 파일이 있어 단순 합과 다릅니다). d9fd9f1과 129d59a의 트리도 ca15663으로 같으니, 최종 파일 상태는 그대로 두고 이력만 되돌린 것입니다. 다만 원본 025f1f0은 저장소에 남아 있지 않아서, 50fcff2와 완전히 같은지는 비교할 수 없습니다.
$ git stash list
$ git cat-file -t 025f1f0
fatal: Not a valid object name 025f1f03. linked worktree가 나누는 것과 공유하는 것
원인을 따지려면 linked worktree가 무엇을 따로 갖고 무엇을 함께 쓰는지부터 알아야 했습니다. git 공식 문서(git-worktree)를 요약하면, 작업 공간마다 따로 갖는 것은 작업 파일과 인덱스, 그리고 HEAD처럼 .git 바로 아래 놓이는 의사 ref입니다. refs/로 시작하는 ref는 refs/bisect, refs/worktree, refs/rewritten을 빼면 모두 공유합니다. 브랜치도, stash가 사는 refs/stash도 여기에 들어갑니다.
| 항목 | 작업 공간마다 따로 | 모든 작업 공간이 공유 |
|---|---|---|
| 파일 | 작업 파일 | 객체 저장소(커밋·트리·blob) |
| 스테이징 | 인덱스 | — |
| 현재 위치 | HEAD, ORIG_HEAD, MERGE_HEAD 같은 의사 ref | 브랜치·태그(refs/heads, refs/tags) |
| 이동 기록 | HEAD의 reflog | 브랜치의 reflog |
| 임시 보관 | — | stash(refs/stash 스택 하나) |
| 예외 ref | refs/bisect, refs/worktree, refs/rewritten | 그 밖의 refs/ 전부 |
| 설정 | config.worktree(따로 켰을 때만) | config |
| 저장소 정리 | — | gc, prune, pack-refs |
재현 실험으로 확인했습니다. /private/tmp 아래 새 저장소의 메인 작업 공간 app(feature/2.x)에 linked worktree app-22(feature/2.2)를 붙였고, git은 2.45.2입니다. 이 글에서 app, app-22가 나오는 출력은 모두 재현 실험이며, 실험마다 저장소를 새로 만들었습니다.
$ git worktree add -b feature/2.2 ../app-22
Preparing worktree (new branch 'feature/2.2')
HEAD is now at 0d99a2f init
$ ls .git/worktrees/app-22
commondir
gitdir
HEAD
index
logs
ORIG_HEAD
refs
$ cd ../app-22
$ git rev-parse --git-dir --git-common-dir
/private/tmp/wt-demo/exp1/app/.git/worktrees/app-22
/private/tmp/wt-demo/exp1/app/.git
$ echo sdk > sdk.txt && git add sdk.txt && git commit -q -m 'chore: SDK 이행' && git log --oneline -1
9469fd0 chore: SDK 이행
$ cd ../app
$ git branch
+ feature/2.2
* feature/2.x
$ git reflog show feature/2.2
9469fd0 feature/2.2@{0}: commit: chore: SDK 이행
0d99a2f feature/2.2@{1}: branch: Created from HEAD
$ git reflog
0d99a2f HEAD@{0}: commit (initial): initlinked worktree가 따로 갖는 것은 .git/worktrees/app-22 아래 HEAD, index, logs 같은 파일 몇 개뿐이고, 나머지는 --git-common-dir이 가리키는 메인 .git을 함께 씁니다. 그래서 app-22의 커밋은 app에서도 브랜치와 브랜치 reflog로 바로 보이지만 app의 HEAD reflog에는 남지 않습니다. 이 차이가 뒤에서 중요해집니다.
$ cd ../app-22
$ git checkout feature/2.x
fatal: 'feature/2.x' is already used by worktree at '/private/tmp/wt-demo/exp1/app'
$ git branch -f feature/2.x HEAD
fatal: cannot force update the branch 'feature/2.x' used by worktree at '/private/tmp/wt-demo/exp1/app'git은 다른 작업 공간이 체크아웃한 브랜치를 또 체크아웃하거나 branch -f로 옮기는 것은 막습니다. 하지만 stash, gc·prune, update-ref 같은 명령에는 이런 확인이 없습니다.
4. 재현 실험 1: 다른 작업 공간의 stash를 꺼낸다
그날 2.2 쪽에서는 git stash를 다섯 번 썼습니다. stash가 저장소에 하나뿐이면 무슨 일이 생기는지 재현했습니다. B(app-22)와 A(app)가 차례로 stash한 뒤, B가 자기 것을 되찾으려고 git stash pop을 실행합니다.
$ cd app-22
$ echo 'B: hive_ce 이행 중' >> board.txt && git stash push -m 'B: 2.2 작업 잠깐 치움'
Saved working directory and index state On feature/2.2: B: 2.2 작업 잠깐 치움
$ cd ../app
$ echo 'A: 카피 수정' > copy.txt && git add copy.txt && git stash push -m 'A: 2.x 카피 수정 잠깐 치움'
Saved working directory and index state On feature/2.x: A: 2.x 카피 수정 잠깐 치움
$ cd ../app-22
$ git stash list
stash@{0}: On feature/2.x: A: 2.x 카피 수정 잠깐 치움
stash@{1}: On feature/2.2: B: 2.2 작업 잠깐 치움
$ git stash pop
On branch feature/2.2
Changes to be committed:
(use "git restore --staged <file>..." to unstage)
new file: copy.txt
Dropped refs/stash@{0} (08a9997c6de3245e89a115f93a6a603cf033c896)
$ cd ../app
$ git stash list
stash@{0}: On feature/2.2: B: 2.2 작업 잠깐 치움
$ git reflog -2
0d99a2f HEAD@{0}: reset: moving to HEAD
0d99a2f HEAD@{1}: commit (initial): initstash pop은 인자가 없으면 맨 위 stash@{0}을 꺼내므로, B는 자기 작업 대신 A의 copy.txt를 받았습니다. 'On feature/2.x'는 기록용 메시지일 뿐 pop은 이를 확인하지 않습니다. A의 목록에는 B의 작업만 남았으니, A가 pop하면 이번에는 B의 작업을 받습니다. 서로 상대의 작업을 자기 브랜치에 커밋하게 되는 길입니다.
이 일이 그날 실제로 일어났는지는 확인하지 못했습니다. stash 목록은 지금 비어 있고, neon_board-22는 이후 정리되면서 그 HEAD reflog도 없어졌습니다. 재현에서 stash push는 HEAD reflog에 reset: moving to HEAD를 남겼고 실제 메인 작업 공간에는 그 시간대에 그런 줄이 없지만, stash pop은 아무것도 남기지 않으니 이것만으로 무관하다고 할 수도 없습니다. 다만 실제로 섞여 든 것은 남의 작업이 아니라 메인 작업 공간 자신의 동작 수정이었으니, stash가 엇갈린 증상과는 결이 다릅니다.
5. 재현 실험 2: 브랜치가 발밑에서 되돌아가면
증상은 커밋 직후 브랜치만 한 칸 뒤로 돌아가고 인덱스는 그대로 남은 모양입니다. 이를 재현하려고 A가 동작 커밋을 만든 직후 B에서 A의 브랜치를 update-ref로 한 칸 되돌렸습니다(branch -f는 막히므로). 그날 이런 명령이 실행됐다는 증거는 없고, 증상의 모양만 보려는 인위적인 실험입니다.
$ echo behavior > behavior.txt && git add behavior.txt && git commit -q -m 'fix: R3 동작' && git log --oneline -2
c37030f fix: R3 동작
0d99a2f init
$ cd ../app-22
$ git update-ref refs/heads/feature/2.x feature/2.x~1
$ cd ../app
$ git log --oneline -1
0d99a2f init
$ git status --short
A behavior.txt
$ echo copy > copy.txt && git add copy.txt && git commit -q -m 'fix: R3 카피' && git show --stat --format='%h %s (parent %p)' HEAD
be85341 fix: R3 카피 (parent 0d99a2f)
behavior.txt | 1 +
copy.txt | 1 +
2 files changed, 2 insertions(+)A의 인덱스는 그대로라 동작 커밋의 변경이 스테이징된 새 파일로 다시 나타나고, 다음 커밋이 그것을 삼킵니다. 실제 증상과 같은 모양입니다. 이어서 reflog와 fsck를 봤습니다.
$ git reflog -3
be85341 HEAD@{0}: commit: fix: R3 카피
c37030f HEAD@{1}: commit: fix: R3 동작
0d99a2f HEAD@{2}: commit (initial): init
$ git reflog show feature/2.x -3
be85341 feature/2.x@{0}: commit: fix: R3 카피
0d99a2f feature/2.x@{1}:
c37030f feature/2.x@{2}: commit: fix: R3 동작
$ git fsck
$ git fsck --no-reflogs
dangling commit c37030fd1f8962a25b69848811f92ee04e2112f5두 가지가 눈에 띕니다. 첫째, A의 HEAD reflog만 보면 동작 커밋 다음에 카피 커밋이 이어진 것처럼 보입니다. 다른 작업 공간에서 브랜치를 직접 고쳤으므로, 되돌린 기록은 브랜치 reflog에만 그것도 메시지 없는 줄로 남았습니다. 둘째, 그냥 git fsck는 조용합니다. reflog가 떨어져 나간 커밋을 붙잡고 있어 도달 가능한 것으로 치기 때문이고, --no-reflogs를 붙여야 dangling commit으로 드러납니다.
그런데 실제 사건은 이 재현과 결정적으로 다릅니다. 재현에서는 떨어져 나간 커밋의 commit: 줄과 되돌린 흔적이 브랜치 reflog에 남았지만, 실제 reflog에는 025f1f0의 커밋 기록부터 없었습니다. 같은 경로는 아니라는 뜻입니다.
6. 끝내 확정하지 못한 것
확인한 것은 동작 커밋이 브랜치에 남지 않았고, 그 변경이 다음 커밋에 섞였으며, 두 커밋으로 다시 만들었다는 데까지입니다. 왜 reflog에 아무것도 남지 않았는지는 확인하지 못했습니다. 재현 실험에서 commit, reset --soft, branch -f, update-ref, stash push는 모두 reflog에 흔적을 남겼습니다.
$ echo x > x.txt && git add x.txt && git commit -q -m 'fix: X' && git reset --soft HEAD~1 && git reflog -2
9f81bc0 HEAD@{0}: reset: moving to HEAD~1
115d138 HEAD@{1}: commit: fix: X
$ git branch -f other HEAD@{1} && git reflog show other -1
115d138 other@{0}: branch: Reset to HEAD@{1}
$ git update-ref -m 'manual move' refs/heads/other HEAD && git reflog show other -1
9f81bc0 other@{0}: manual move그런데도 흔적이 없다면, 커밋 객체만 만들어지고 브랜치 갱신은 일어나지 않았거나 git 명령을 거치지 않고 ref·reflog 파일이 바뀌었을 가능성이 남습니다. 어느 쪽인지 가릴 증거는 없습니다. 또 08:14:26에는 엔진 작업용 worktree의 feature/engine-effects 브랜치에도 커밋이 하나 올라갔는데, 이 커밋이 사건과 관계있는지는 모릅니다.
객체가 없어진 경위도 모릅니다. 네온보드 저장소의 pack 디렉터리는 비어 있습니다. gc가 돌았다면 pack 파일이 남았을 테니 gc가 지웠다고 보기는 어렵습니다. git prune은 다릅니다. gc는 기본 설정에서 2주가 안 된 도달 불가능 객체를 남기지만, 옵션 없는 git prune은 기한 없이 지우고, 다른 작업 공간에서 실행해도 같은 객체 저장소를 지웁니다. 아래 git stash create는 ref·reflog 어디에도 걸리지 않은 커밋 객체를 만들려고 썼습니다.
$ echo wip >> board.txt && git stash create
30da6a2013f60d8dd5209eef8a4b651bda602565
$ git cat-file -t 30da6a2
commit
$ cd ../app-22
$ git prune -v
30da6a2013f60d8dd5209eef8a4b651bda602565 commit
533e3f54b0f2a45d680ab98a3e65379b8f0b187b commit
70c5f1c68e871d4cfa836dd412d6af9a0c6d3662 blob
709788d253d3d6fd666e575b8b4fb083fd9cd763 tree
$ cd ../app
$ git cat-file -t 30da6a2
fatal: Not a valid object name 30da6a2실제 저장소에서 025f1f0을 찾을 때와 같은 메시지입니다. 하지만 prune은 실행 기록을 남기지 않아 그 저장소에서 돌았는지 확인할 수 없고, 애초에 객체가 기록되지 않았을 가능성도 지우지 못했습니다. 이 재현은 가능한 경로 하나일 뿐입니다.
7. worktree로 병렬 작업할 때 규칙
원인을 하나로 좁히지 못했으니, 규칙은 용의자 하나가 아니라 공유 상태를 건드리는 명령 전체를 막는 쪽으로 세웠습니다. 그날 오전 규칙으로 적어 두고, 이 저장소에서 병렬 작업을 시작할 때마다 먼저 확인하도록 했습니다.
첫째, 작업 공간마다 자기 브랜치에서만 커밋합니다. 다른 작업 공간의 브랜치는 읽기만 하고, 병합은 넷째 항목의 점검을 마친 뒤에 합니다.
둘째, 공유 상태를 바꾸는 명령은 쓰지 않습니다. git stash, git gc, git prune, 그리고 다른 브랜치를 움직이는 reset, branch -f, update-ref입니다. git의 보호 장치는 체크아웃된 브랜치를 겨냥한 일부 명령에만 걸려 있으니, 나머지는 규칙으로 막아야 합니다.
셋째, stash가 필요한 순간에는 임시 worktree를 씁니다. 지금 작업을 치우는 대신, 깨끗한 HEAD가 필요한 확인을 따로 붙인 작업 공간에서 하고 지웁니다.
$ echo 'A: 작업 중' > copy.txt && git add copy.txt && git status --short
A copy.txt
$ git worktree add --detach ../app-check HEAD
Preparing worktree (detached HEAD 9f81bc0)
HEAD is now at 9f81bc0 init
$ git -C ../app-check status --short; ls ../app-check
board.txt
$ git worktree remove ../app-check && git worktree list
/private/tmp/wt-demo/exp5/app 9f81bc0 [feature/2.x]
$ git status --short
A copy.txt--detach로 만들면 브랜치가 새로 생기지 않아 정리할 것도 작업 공간 하나뿐입니다. 원래 작업 공간의 스테이징 상태는 그대로 남습니다.
넷째, 병렬 작업이 끝나면 병합 전에 브랜치마다 reflog를 훑고, git fsck --no-reflogs로 브랜치에서 떨어져 나간 커밋이 없는지 봅니다.
# 1) 브랜치마다 reflog를 훑는다: 메시지 없는 줄, 예상하지 못한 reset·branch 이동이 없는지
git reflog show --date=iso feature/neonboard-2.x | head -30
git reflog show --date=iso feature/2.2-modernize | head -30
# 2) reflog를 빼고 봤을 때 브랜치에서 떨어져 나간 커밋이 있는지
git fsck --no-reflogs
# 3) 나온 커밋의 내용을 보고, 살릴 것은 브랜치로 붙잡는다
git show --stat <커밋 해시>
git branch rescue/r3-behavior <커밋 해시>amend 전 커밋이나 일부러 다시 만든 커밋도 dangling commit으로 함께 나오므로, 메시지를 보고 의도하지 않은 것만 골라냅니다. 그날 사라진 커밋처럼 reflog에 아무 기록이 없는 커밋은 사실상 fsck 말고는 찾을 길이 없습니다.
돌아보면 worktree가 나눠 준 것은 작업 파일과 인덱스, HEAD뿐이었습니다. 폴더가 다르다고 저장소가 다른 것은 아니었습니다. 여러 작업을 동시에 돌린다면 공유 상태에 닿는 명령을 목록으로 막아 두는 편이 안전합니다. 사라진 이유는 끝내 밝히지 못했지만, 같은 일이 다시 생겨도 병합 전에 알아챌 기회는 생겼습니다.