Como você desfaz alterações no Git?

Question

Accepted Answer

O Git oferece várias maneiras de **desfazer alterações** dependendo da situação — descartar alterações não confirmadas, remover do índice, corrigir o último commit, reverter um commit ou fazer reset. Conhecer a ferramenta correta para cada situação é uma habilidade prática importante e valiosa. ## Desfazer alterações não confirmadas (diretório de trabalho) ```bash git restore # discard unstaged changes to a file (revert to last commit) git checkout -- # older equivalent git restore . # discard ALL unstaged changes (careful!) git clean -fd # remove untracked files/directories ``` ## Remover do índice (manter as alterações, apenas remover do índice) ```bash git restore --staged # unstage a file (changes stay in working dir) git reset # older equivalent ``` ## Corrigir ou corrigir o último commit ```bash git commit --amend -m "New message" # change the last commit's message git commit --amend # add staged changes to the last commit # ⚠️ amend REWRITES the commit — don't amend commits already pushed/shared ``` ## Desfazer uma alteração confirmada ```text TWO main approaches: REVERT → creates a NEW commit that undoes a previous commit (SAFE for shared history) git revert → history preserved; the undo is itself a commit RESET → moves the branch pointer BACK (rewrites history — for LOCAL commits only) git reset --soft HEAD~1 → undo commit, KEEP changes staged git reset --mixed HEAD~1 → undo commit, keep changes unstaged (default) git reset --hard HEAD~1 → undo commit AND DISCARD changes (⚠️ destructive!) ``` ## revert vs reset (a escolha fundamental) ```text REVERT → safe for PUBLIC/shared commits (adds a new undoing commit; doesn't rewrite history) RESET → rewrites history (only for LOCAL, unpushed commits; never on shared branches) → Rule: use REVERT to undo commits others may have; RESET only for local cleanup. ``` ## Por que isso importa Saber como desfazer alterações no Git é uma habilidade prática importante e frequentemente necessária, porque erros e a necessidade de desfazer trabalho são inevitáveis no desenvolvimento, e o Git oferece maneiras poderosas (mas específicas para cada situação) para recuperar. Compreender a **ferramenta correta para cada situação** é a habilidade fundamental: descartar **alterações não confirmadas** (`git restore` para reverter edições do diretório de trabalho, `git clean` para arquivos não rastreados), **remover do índice** (`git restore --staged` para manter as alterações mas removê-las do índice), **corrigir** o último commit (alterando sua mensagem ou adicionando a ele — com a importante ressalva de não corrigir commits já enviados, pois reescreve o histórico), e desfazer alterações **confirmadas**. Para desfazer commits, compreender a **distinção crítica entre revert e reset** é especialmente importante: **`revert`** cria um novo commit que desfaz um anterior e é **seguro para histórico compartilhado/público** (não reescreve o histórico, portanto não prejudicará outros), enquanto **`reset`** move o ponteiro do branch para trás e **reescreve o histórico**, tornando apropriado apenas para **commits locais não enviados** (e `reset --hard` é destrutivo, descartando alterações). A regra — use `revert` para commits que outros possam ter, `reset` apenas para limpeza local — é vital porque reescrever histórico compartilhado (via reset em commits enviados) causa sérios problemas para colaboradores. Conhecer essas opções previne tanto perder trabalho (usando comandos destrutivos imprudentemente) quanto prejudicar a colaboração (reescrevendo histórico compartilhado). Como desfazer alterações é uma necessidade comum e inevitável e o Git oferece múltiplas abordagens específicas para cada situação com implicações importantes de segurança (especialmente revert vs reset para histórico compartilhado), saber como desfazer alterações no Git — a ferramenta correta para cada cenário e a distinção crucial entre revert e reset — é conhecimento prático valioso e frequentemente aplicado para trabalhar com confiança e segurança com Git, uma habilidade que transforma a ansiedade dos erros em recuperação rotineira enquanto evita a séria armadilha de reescrever histórico compartilhado.