Introdução
Git é um poderoso sistema de controle de versão que permite aos desenvolvedores gerenciar seu código-fonte de forma eficaz. Uma tarefa comum é desfazer alterações. Enquanto comandos como git reset podem alterar o histórico de commits, git revert oferece uma maneira mais segura e não destrutiva de desfazer commits, especialmente em projetos colaborativos. Este laboratório irá guiá-lo através do uso de git revert para desfazer um commit e como usar suas opções para preservar suas alterações para modificações futuras.
Inspecionando o Histórico de Commits
Antes de fazermos quaisquer alterações, é essencial entender o estado atual do nosso projeto. O ambiente de laboratório foi pré-configurado com um repositório Git contendo um arquivo chamado story.txt e alguns commits. Vamos inspecionar o histórico de commits.
Primeiro, use o comando git log com a opção --oneline para obter uma visualização compacta do histórico de commits. Este comando lista cada commit em uma única linha, mostrando o hash do commit e a mensagem do commit.
git log --oneline
Você deverá ver uma saída semelhante a esta. Observe que seus hashes de commit serão diferentes:
c7a3e69 (HEAD -> master) Add a second, unwanted line
a9b2d5f Add the first line to the story
f3e1c8a Initial commit: Add story.txt
Este log mostra três commits. O commit mais recente, no topo, tem a mensagem "Add a second, unwanted line". Vamos fingir que este commit introduziu um erro que precisamos desfazer.
Vamos também visualizar o conteúdo atual do arquivo story.txt:
cat story.txt
A saída será:
Once upon a time, in a land of code.
The hero of our story was a brave developer.
Suddenly, a wild bug appeared!
Nosso objetivo é remover a última linha, "Suddenly, a wild bug appeared!", que foi adicionada em nosso commit mais recente.
Usando git revert para um Desfazer Seguro
O comando git revert é usado para criar um novo commit que desfaz as alterações de um commit anterior. Este é um método seguro para desfazer alterações porque não altera o histórico do projeto.
Primeiro, copie o hash do commit que você deseja reverter. Da saída da etapa anterior, este é o commit com a mensagem "Add a second, unwanted line".
Agora, execute o comando git revert com esse hash.
Por favor, substitua
<your-commit-hash>pelo hash real do seu terminal.
git revert <your-commit-hash>
Após executar este comando, o Git abrirá seu editor de texto padrão (nano) para permitir que você edite a mensagem do commit para este novo commit de reversão. A mensagem padrão geralmente é suficiente.
Para salvar e sair do nano:
- Pressione
Ctrl+O(Write Out) e depoisEnterpara confirmar o nome do arquivo. - Pressione
Ctrl+Xpara sair.
Agora, vamos verificar o histórico de commits novamente:
git log --oneline
Você verá um novo commit no topo:
e0d5f1b (HEAD -> master) Revert "Add a second, unwanted line"
c7a3e69 Add a second, unwanted line
a9b2d5f Add the first line to the story
f3e1c8a Initial commit: Add story.txt
Observe que o commit original "indesejado" ainda está no histórico, mas um novo commit de "Reversão" foi adicionado. Este novo commit reverte as alterações feitas pelo commit indesejado.
Finalmente, verifique o conteúdo de story.txt para confirmar que a alteração foi desfeita:
cat story.txt
A saída agora deve ser:
Once upon a time, in a land of code.
The hero of our story was a brave developer.
A linha indesejada foi removida com sucesso.
Revertendo Mantendo Alterações com --no-commit
Às vezes, você deseja desfazer as alterações de um commit, mas mantê-las em seu diretório de trabalho para modificá-las. Por exemplo, você pode querer corrigir um erro no commit em vez de descartá-lo completamente. A opção --no-commit (ou -n) é perfeita para isso.
Primeiro, vamos redefinir nosso repositório para o estado anterior ao nosso último revert, para que possamos tentar uma abordagem diferente. Usaremos git reset para isso. Este comando move o ponteiro HEAD e --hard atualiza os arquivos em seu diretório de trabalho para corresponder.
git reset --hard HEAD~1
Este comando remove o commit de "Reversão" que acabamos de fazer. Você pode confirmar isso executando git log --oneline.
Agora, vamos reverter o commit "indesejado" novamente, mas desta vez usando a opção --no-commit. Lembre-se de usar o hash do commit "Add a second, unwanted line".
Por favor, substitua
<your-commit-hash>pelo hash real do seu terminal.
git revert --no-commit <your-commit-hash>
Desta vez, nenhum editor aparece. A reversão é preparada, mas não commitada. Verifique o status do seu repositório:
git status
A saída mostrará que story.txt está preparado para commit:
On branch master
Changes to be committed:
(use "git restore --staged <file>..." to unstage)
modified: story.txt
As alterações do commit revertido agora estão na sua área de staging. Você pode modificá-las agora. Vamos substituir a linha indesejada por uma melhor. Abra story.txt com nano:
nano story.txt
O arquivo ficará como estava após a reversão na Etapa 2. Adicione uma nova linha, melhor, ao final do arquivo:
And they lived happily ever after.
Salve e saia do nano (Ctrl+O, Enter, Ctrl+X).
Agora, adicione suas alterações à área de staging e faça o commit delas com uma nova mensagem descritiva:
git add story.txt
git commit -m "Replace unwanted line with a proper conclusion"
Finalmente, verifique o log e o conteúdo do arquivo para ver o resultado:
git log --oneline
cat story.txt
O log mostra seu novo commit, e story.txt tem o conteúdo corrigido. Você reverteu com sucesso um commit, preservando e modificando suas alterações.
Resumo
Neste laboratório, você aprendeu como reverter com segurança um commit do Git sem perder seu trabalho. Você praticou a inspeção do histórico de commits com git log, a execução de um git revert padrão para criar um novo commit que desfaz alterações anteriores e o uso da opção git revert --no-commit para reverter alterações para sua área de staging, permitindo que você as modifique antes de criar um novo commit. Essas técnicas são essenciais para gerenciar o histórico do seu projeto de forma limpa e segura, especialmente em um ambiente de equipe.
