Passo a passo: Como modificar a mensagem do último commit no Git

Como modificar a mensagem do último commit?

Se você cometeu um erro ao escrever a mensagem do último commit no Git, não precisa criar um novo commit para corrigir isso. O Git oferece uma maneira simples de alterar a última mensagem sem afetar o histórico de commits.

Alterando a mensagem do último commit

Para modificar a mensagem do último commit, utilize o seguinte comando:

git commit --amend -m "Nova mensagem para o commit"

Esse comando reabre o último commit e permite substituir a mensagem anterior por uma nova.

Editando a mensagem do último commit no editor padrão

Se preferir editar a mensagem dentro do editor padrão configurado no Git, utilize:

git commit --amend

Isso abrirá a mensagem do último commit no editor de texto, permitindo que você faça as alterações necessárias.

O que acontece ao modificar um commit?

Quando um commit é alterado com --amend, ele recebe um novo identificador (SHA), pois o Git considera que um commit modificado é, na prática, um novo commit.

⚠️ Atenção: Se o commit já foi enviado para um repositório remoto, modificar a mensagem pode causar problemas para outros desenvolvedores. Para evitar conflitos, utilize git push --force com cautela:

git push --force

Se já tiver compartilhado o commit, prefira criar um novo commit com a correção em vez de usar --amend.

Por que organizar as mensagens de commit é essencial?

Cometer erros em mensagens de commit é algo comum no dia a dia do desenvolvimento. No entanto, manter um histórico de commits limpo e organizado facilita a leitura e auditoria do código. O comando git commit --amend é útil para corrigir rapidamente pequenos erros sem criar commits desnecessários.

Embora seja uma prática recomendada para commits locais, deve-se ter cautela ao modificar commits que já foram enviados para um repositório remoto. Alterar um commit já compartilhado pode causar problemas de sincronização para outros desenvolvedores. Por isso, sempre verifique o status do repositório antes de forçar a atualização.

Algumas aplicações:

• Corrigir erros de digitação ou informações incorretas na mensagem do commit
• Padronizar mensagens de commit sem criar novos commits
• Evitar um histórico poluído com commits desnecessários
• Facilitar a compreensão do histórico do projeto
• Melhorar a rastreabilidade de alterações no código

Dicas para quem está começando

• Use 'git commit --amend' apenas para commits locais ainda não enviados ao repositório remoto.
• Se já tiver enviado o commit, prefira criar um novo commit com a correção.
• Verifique sua mensagem antes de commitá-la para evitar edições frequentes.
• Se estiver colaborando com um time, avise os colegas antes de forçar uma atualização no repositório remoto.
• Evite alterar commits antigos, pois isso pode causar problemas na sincronização do repositório.

Compartilhe este tutorial