Dicionário de TI de A a Z

O que é GIT revert?

O que é GIT revert? é um comando fundamental do Git que permite desfazer alterações em um repositório de forma segura e rastreável. Diferentemente de outras operações de desfazer, o GIT revert cria um novo commit que inverte as mudanças de um commit anterior, mantendo todo o histórico do projeto intacto. Esta é uma das práticas mais importantes para trabalhar com controle de versão em equipes, especialmente quando você precisa reverter alterações que já foram compartilhadas com outros desenvolvedores.

Como o GIT revert funciona

O GIT revert funciona criando um novo commit que contém as mudanças opostas ao commit que você deseja reverter. Quando você executa o comando, o Git analisa o commit específico e cria uma nova versão que desfaz exatamente aquelas alterações. Este processo é seguro porque não altera o histórico existente, apenas adiciona novos commits ao topo do seu branch.

O comando básico é simples: git revert <commit-hash>. Você substitui <commit-hash> pelo identificador do commit que deseja reverter. O Git então abre seu editor padrão para que você escreva uma mensagem de commit explicando por que está revertendo essa alteração. Esta mensagem é crucial para manter a documentação clara do projeto.

A grande vantagem do GIT revert é que ele preserva a história completa do repositório. Todos os commits permanecem visíveis, e futuros desenvolvedores podem entender exatamente o que foi feito e por quê. Isto contrasta com comandos como git reset, que podem reescrever o histórico e causar problemas em repositórios compartilhados.

Diferenças entre revert e reset

Muitos desenvolvedores confundem o GIT revert com o comando git reset, mas eles funcionam de maneiras completamente diferentes. O git reset move o ponteiro HEAD para um commit anterior e pode descartar commits, enquanto o GIT revert cria um novo commit que desfaz as alterações de um commit específico.

O git reset é mais agressivo e pode reescrever o histórico do repositório, o que é perigoso quando você trabalha com outros desenvolvedores. Se você usar git reset em um repositório compartilhado, pode gerar conflitos sérios e perder trabalho. O GIT revert, por outro lado, é completamente seguro para usar em repositórios compartilhados porque apenas adiciona novos commits.

Outra diferença importante é a reversibilidade. Com o GIT revert, você sempre pode reverter a reversão se necessário, simplesmente executando o comando novamente. Com git reset, você pode perder permanentemente alterações e ter dificuldade em recuperá-las, especialmente se já fez push para o repositório remoto.

Cenários práticos para usar GIT revert

Um cenário comum é quando um desenvolvedor percebe que um commit introduziu um bug. Depois que o commit foi compartilhado com a equipe, usar o GIT revert é a abordagem correta. Por exemplo, se o commit abc123 quebrou funcionalidade importante, você pode executar git revert abc123 e todos os seus colegas receberão o commit de reversão quando fizerem pull das atualizações.

Outro cenário é reverter múltiplos commits em sequência. Se você precisa reverter uma série de commits consecutivos, pode usar git revert <commit-inicio>..<commit-final>. Isto criará múltiplos commits de reversão, um para cada commit que está sendo desfeito. O GIT revert é particularmente útil quando você identifica que uma feature inteira causou problemas após ser implementada.

Também é comum usar o GIT revert em ambientes de produção onde o histórico é crítico. Se uma versão em produção precisar ser revertida, o GIT revert garante que o que foi revertido fica documentado no histórico. Equipes de DevOps e arquitetos de software frequentemente preferem o GIT revert porque mantém uma trilha de auditoria completa de todas as mudanças.

Sintaxe e opções do comando

A sintaxe mais simples do GIT revert é git revert <commit>, mas existem várias opções úteis disponíveis. A opção --no-edit permite usar a mensagem de commit padrão sem abrir um editor. Já --no-commit prepara as mudanças de reversão sem criar um commit, permitindo que você faça modificações adicionais antes de confirmar.

Se você está revertendo um commit de merge, você precisa usar git revert -m 1 <merge-commit>. O número após -m especifica qual é o “mainline” do merge (geralmente 1 para o primeiro parent). Isto é crucial porque commits de merge têm múltiplos parents, e o Git precisa saber qual linha você quer manter.

A opção --abort é útil se você começou um revert mas quer cancelar a operação. Use git revert --abort para voltar ao estado anterior. Se houver conflitos durante o revert, você pode resolvê-los manualmente e depois usar git revert --continue para completar a operação.

Tratando conflitos com GIT revert

Às vezes, quando você tenta executar um GIT revert, o Git encontra conflitos com mudanças posteriores. Isto acontece quando o commit que você está revertendo modificou linhas que foram alteradas novamente em commits posteriores. O Git então pausará o revert e pedirá que você resolva os conflitos.

Para resolver conflitos, você precisa editar os arquivos afetados e remover os marcadores de conflito. Os arquivos conterão seções marcadas com <<<<<<<, =======, e >>>>>>> que indicam as mudanças conflitantes. Após resolver manualmente os conflitos, você faz stage dos arquivos com git add e depois usa git revert --continue para concluir o revert.

Uma boa prática é testar completamente o repositório após resolver conflitos de um revert. Certifique-se de que o código compila, que os testes passam, e que a funcionalidade esperada funciona corretamente. Isto garante que sua reversão não introduza novos problemas enquanto tenta corrigir o anterior.

Boas práticas e dicas profissionais

Sempre escreva mensagens de commit descritivas quando usa o GIT revert. Em vez de apenas “Revert abc123”, explique por que você está revertendo: “Revert abc123: remove validação de email que estava rejeitando endereços válidos”. Isto ajuda outros desenvolvedores a entender o contexto quando olham o histórico posteriormente.

Antes de fazer um revert em um repositório compartilhado, considere comunicar sua intenção à equipe. Se vários desenvolvedores têm trabalho baseado no commit que você vai reverter, avise-os para evitar conflitos de merge. Isto é especialmente importante se você trabalha em um ambiente de equipe grande ou em projetos com muitos contributors.

Use git log e git show para revisar cuidadosamente o commit antes de revertê-lo. Certifique-se de que você está revertendo o commit correto e entende completamente que mudanças serão desfeitas. Erros com revert são raros, mas é melhor ser cuidadoso. Considere fazer um backup ou branch de teste antes de reverter commits críticos em produção.

Ferramentas gráficas e alternativas

Embora o GIT revert seja um comando de linha de comando, muitas ferramentas gráficas oferecem interfaces visuais para executar revertes. GitKraken, Sourcetree, e GitHub Desktop todos permitem reverter commits com alguns cliques. Isto pode ser mais intuitivo para desenvolvedores menos experientes com a linha de comando.

Plataformas como GitHub, GitLab, e Bitbucket também oferecem botões de revert diretamente em pull requests e commits. Isto é extremamente conveniente porque você pode reverter um commit sem mesmo clonar o repositório localmente. A funcionalidade funciona exatamente como o GIT revert, criando um novo commit com as mudanças inversas.

Para workflows mais complexos, você pode integrar o GIT revert em scripts de CI/CD. Muitos pipelines automatizados usam revert como parte de sua estratégia de rollback. Se um teste falhar ou uma métrica sair do normal, o pipeline pode automaticamente reverter o commit problemático e notificar a equipe.

Quando usar git revert vs git reset?

Use git revert quando o commit já foi compartilhado com outros desenvolvedores ou quando você quer manter um histórico completo. Use git reset apenas para commits locais que ainda não foram compartilhados, especialmente quando quer limpar seu histórico local antes de fazer um push.

É seguro usar GIT revert em produção?

Sim, é muito seguro. Na verdade, é uma das formas mais seguras de desfazer mudanças em produção porque mantém o histórico completo. Basta ter cuidado para testar as mudanças antes de fazer push e comunicar à equipe sobre o revert.

Posso reverter um revert?

Sim! Se você reverter um commit e depois perceber que foi um erro, pode usar git revert novamente no commit de revert para restaurar as mudanças originais. Isto cria uma cadeia clara no histórico mostrando que algo foi desfeito e depois refeito.

Como reverter múltiplos commits de uma vez?

Use git revert <commit-antigo>..<commit-novo> para reverter um intervalo de commits. Isto criará um commit de revert para cada commit no intervalo. Certifique-se de que a ordem está correta e de que não há commits que você quer manter no meio.

O que fazer se o revert criar conflitos?

Resolvea os conflitos manualmente editando os arquivos, removendo os marcadores de conflito, e depois executando git revert --continue. Se as coisas ficarem muito complicadas, você sempre pode usar git revert --abort para começar novamente.

Referências úteis:

Curiosidade: O GIT revert foi uma das primeiras operações implementadas no Git porque Linus Torvalds reconheceu a importância de manter a história completa enquanto desfaz mudanças. Diferentemente de muitos sistemas de controle de versão mais antigos, o Git foi projetado desde o início para suportar essa funcionalidade de forma segura e confiável.