git reflog로 잃어버린 commit을 어떻게 복구하나요?

Question

Accepted Answer

**git reflog**는 branch의 HEAD가 어디에 있었는지 — 모든 commit, checkout, reset, rebase 등 — 를 기록합니다. 사라진 것처럼 보이지만 여전히 복구 가능한 **"잃어버린" commit을 복구**하기 위한 안전망입니다(잘못된 reset, rebase, branch 삭제 후).

## reflog란

```text
reflog는 로컬 repo에서 HEAD(와 branch 끝)의 모든 이동을 기록합니다:
  → 모든 commit, checkout, reset, rebase, merge 등이 참조와 함께 기록됨
  → 로컬이며 어떤 branch에서도 도달할 수 없는 commit("잃어버린" 것)도 포함
→ reset/rebase로 commit을 없애도, reflog는 그것들이 어디 있었는지 기억함.
```

## 잃어버린 작업 복구하기

```bash
git reflog                     # HEAD 이동의 히스토리 표시
# 예시 출력:
#   abc123 HEAD@{0}: reset: moving to HEAD~3
#   def456 HEAD@{1}: commit: Important work    ← "잃어버린" commit!
#   ...

# 복구: 잃어버린 commit은 def456 — 되찾기
git checkout def456            # 확인
git branch recovered def456    # 거기에 branch 생성(저장)
# 또는 거기로 reset:
git reset --hard def456        # HEAD를 그 commit으로 복원
```

commit이 사라진 것처럼 보일 때(`reset --hard`, 잘못된 rebase, branch 삭제 후), `git reflog`는 HEAD가 어디 있었는지 보여주고, 해시로 commit을 복구할 수 있습니다(checkout, branch 생성, 또는 reset).

## 일반적인 복구 시나리오

```text
✓ git reset --hard 후(commit 버려짐) → reflog에서 찾아 reset back
✓ 잘못된 rebase 후(commit rewrite/손실) → reflog에 rebase 이전 상태
✓ branch 삭제 후 → 마지막 commit이 reflog에 → branch 재생성
✓ 고아처럼 보이는 "detached HEAD" commit → reflog가 찾음
→ commit이 로컬에 존재했다면, reflog로 보통 복구 가능(GC까지, ~수 주).
```

## 왜 중요한가

`git reflog`를 이해하는 것은 **잃어버린 작업을 복구하는 안전망**으로서 가치 있으므로, 겉보기에 치명적인 실수로부터 구해줄 수 있는 중요한 실무 지식입니다.

히스토리를 rewrite하거나 HEAD를 이동시키는 Git 작업 — `reset --hard`, 잘못된 rebase, branch 삭제 — 은 commit을 **잃어버린 것처럼** 보이게 할 수 있는데, 이는 놀랍고 되돌릴 수 없어 보입니다.

결정적인 통찰은 이 commit들이 보통 **실제로 사라진 것이 아니라는** 점입니다. `git reflog`는 로컬에서 HEAD의 모든 이동(모든 commit, checkout, reset, rebase)을 기록하며, 어떤 branch에서도 더 이상 도달할 수 없는 commit도 포함하므로, "잃어버린" commit이 어디 있었는지 기억합니다.

이는 reflog를 강력한 **복구 도구**로 만듭니다. 잘못된 reset, 실패한 rebase, 삭제된 branch 후 작업이 사라진 것처럼 보일 때, `git reflog`로 commit의 해시를 찾아 복구할 수 있습니다(checkout, 거기에 branch 생성, 또는 reset back).

**일반적인 복구 시나리오**(`reset --hard`, 잘못된 rebase, branch 삭제, 고아 detached-HEAD commit 후 복구)와, commit이 로컬에 존재했다면(보통 수 주 후의 가비지 컬렉션까지) 복구가 가능하다는 점을 이해하는 것은 가치 있는 실무 지식입니다.

이 안전망은 안심을 주고 진정으로 유용합니다. 많은 "작업을 잃어버렸어!" 상황이 복구 가능하다는 것을 의미하여, Git의 히스토리 rewrite 작업에 대한 두려움의 상당 부분을 없앱니다.

commit을 잃어버린 것처럼 보이게 하는 실수는 흔하고(특히 reset과 rebase 같은 강력한 명령을 배우거나 사용할 때), reflog가 그것들을 복구하는 도구(종종 패닉을 빠른 해결로 바꿈)이므로, `git reflog`를 이해하는 것 — 무엇을 기록하는지, 잃어버린 commit을 어떻게 복구하는지, 일반적인 복구 시나리오 — 은 필수적인 안전망으로서 가치 있고 실무적으로 관련된 Git 지식입니다. 이는 잃어버린 작업이 보통 복구될 수 있음을 알고 Git의 강력한 기능을 사용할 자신감을 주는 도구이자 모든 개발자에게 진정으로 안심이 되는 지식입니다.