Desfazendo Erros: restore, reset, revert — O Caminho Correto e os Perigos

Git restore: o botão desfazer para arquivos

• Git restore — desfaz alterações não commitadas
• Funciona como o botão 'desfazer' do editor
• Seguro — não altera o histórico de commits
• Retorna os arquivos para o último estado salvo

Imagine que você salvou acidentalmente um arquivo com erros e quer voltar ao estado anterior. O Git restore age como um botão mágico de desfazer — ele retorna os arquivos para o último estado confirmado. Diferente de outros comandos de desfazer, o restore trabalha apenas com alterações não commitadas e é completamente seguro para o histórico do seu projeto. É a primeira ferramenta a ser usada quando você precisa corrigir rapidamente uma situação sem arriscar o histórico de alterações.

Desfazendo alterações no diretório de trabalho

• git restore arquivo.txt — retorna o arquivo para o último commit
• Desfaz todas as alterações no diretório de trabalho
• Seguro — as alterações podem ser recuperadas pelo editor
• Verifique o status com git status antes de restaurar

Suponha que você passou meia hora editando um arquivo de configuração, mas percebeu que está no caminho errado. Em vez de reverter cada alteração manualmente, execute git restore config.yml. O arquivo voltará instantaneamente ao estado do último commit. É como se você simplesmente fechasse o arquivo sem salvar, mas com a garantia de que está retornando a uma versão funcional.

# Demonstração de restauração de arquivo
$ echo "Alterações incorretas" > main.py
$ git status
$ git restore main.py
$ cat main.py
$ git status

Removendo arquivo do índice

• git restore --staged file.txt — remove o arquivo do índice
• Mantém as alterações no diretório de trabalho
• Cuidado: sem --staged as alterações serão perdidas
• Sempre verifique o git status antes de executar

Um erro comum é adicionar acidentalmente um arquivo desnecessário ao índice. Por exemplo, você executou git add ponto e incluiu um arquivo temporário de configuração. O comando git restore com a flag --staged e o nome do arquivo, como settings.tmp, removerá cuidadosamente o arquivo do índice, mas manterá todas as alterações no diretório de trabalho. Sem a flag --staged, você perderia seu trabalho, então sempre verifique o status com git status antes de executar o restore. Agora você sabe desfazer alterações antes do commit. Mas e se o erro já estiver no histórico? É aí que o git reset entra em cena.

# Arquivo adicionado ao índice por engano
$ git add config.tmp
$ git status

# Remove do índice mantendo as alterações
$ git restore --staged config.tmp
$ git status

# Verifica se o arquivo permaneceu no diretório de trabalho
$ ls -la config.tmp