Como você recupera commits perdidos com git reflog?

Question

Accepted Answer

**git reflog** registra onde o HEAD do seu branch esteve — cada commit, checkout, reset, rebase, etc. É uma rede de segurança para **recuperar commits "perdidos"** (após um reset ruim, rebase malfeito ou exclusão de branch) que parecem desaparecidos mas ainda são recuperáveis.

## O que é reflog

```text
The REFLOG logs every movement of HEAD (and branch tips) in YOUR local repo:
  → every commit, checkout, reset, rebase, merge, etc. is recorded with a reference
  → it's LOCAL and includes commits not reachable from any branch (the "lost" ones)
→ Even if you reset/rebase away commits, reflog remembers where they were.
```

## Recuperando trabalho perdido

```bash
git reflog                     # show the history of HEAD movements
# example output:
#   abc123 HEAD@{0}: reset: moving to HEAD~3
#   def456 HEAD@{1}: commit: Important work    ← the "lost" commit!
#   ...

# recover: the lost commit is def456 — get it back
git checkout def456            # inspect it
git branch recovered def456    # create a branch at it (save it)
# or reset back to it:
git reset --hard def456        # restore HEAD to that commit
```

Quando commits parecem perdidos (após `reset --hard`, um rebase malfeito ou exclusão de um branch), `git reflog` mostra onde o HEAD estava, e você pode recuperar o commit por seu hash (fazendo checkout dele, criando um branch ou fazendo reset para ele).

## Cenários comuns de recuperação

```text
✓ After git reset --hard (discarded commits) → find them in reflog, reset back
✓ After a bad rebase (rewrote/lost commits) → reflog has the pre-rebase state
✓ After deleting a branch → its last commit is in reflog → recreate the branch
✓ "Detached HEAD" commits that seem orphaned → reflog finds them
→ As long as commits existed locally, reflog usually can recover them (until GC, ~weeks).
```

## Por que isso importa

Entender `git reflog` é valioso como uma **rede de segurança para recuperar trabalho perdido**, por isso é um conhecimento prático importante que pode salvá-lo de erros que parecem catastróficos.

Operações do Git que reescrevem histórico ou movem HEAD — `reset --hard`, rebases malfeitos, exclusão de branches — podem fazer commits **parecerem perdidos**, o que é alarmante e parece irreversível.

A percepção crucial é que esses commits geralmente **não estão realmente desaparecidos**: `git reflog` registra cada movimento do HEAD localmente (cada commit, checkout, reset, rebase), incluindo commits não mais alcançáveis a partir de nenhum branch, então se lembra de onde commits "perdidos" estavam.

Isso torna reflog uma poderosa **ferramenta de recuperação** — quando trabalho parece perdido após um reset ruim, um rebase malfeito ou exclusão de um branch, você pode usar `git reflog` para encontrar o hash do commit e recuperá-lo (fazendo checkout, criando um branch nele ou fazendo reset para ele).

Entender os **cenários comuns de recuperação** (recuperação após `reset --hard`, rebases ruins, exclusão de branch e commits em HEAD destacado órfãos) e que a recuperação funciona enquanto os commits existiram localmente (até coleta de lixo, tipicamente semanas depois) é um conhecimento prático valioso.

Essa rede de segurança é reconfortante e genuinamente útil — significa que muitas situações "Perdi meu trabalho!" são recuperáveis, removendo muito do medo em torno de operações de reescrita de histórico do Git.

Como erros que parecem perder commits são comuns (especialmente ao aprender ou usar comandos poderosos como reset e rebase), e como reflog é a ferramenta que os recupera (frequentemente transformando um pânico em uma correção rápida), entender `git reflog` — o que registra, como recuperar commits perdidos e os cenários comuns de recuperação — é um conhecimento Git valioso e praticamente relevante como uma rede de segurança essencial, uma ferramenta que fornece confiança para usar os recursos poderosos do Git sabendo que trabalho perdido geralmente pode ser recuperado, e um conhecimento genuinamente reconfortante para qualquer desenvolvedor.