Mensagem de Commit: O Único Jeito Certo
Descubra o erro mais comum e elimine toda dúvida ao criar mensagens de commit. O truque é simples, prático e deixa seu Git organizado e profissional.
Por que isso é importante
A escolha das palavras na mensagem de commit impacta o entendimento e a manutenção de qualquer projeto em equipe. Mensagens erradas criam confusão, dificultam rastreio e atrasam o progresso. Aplicar a lógica certa transforma seu fluxo de desenvolvimento e entrega.
A Regra das Seis Palavras para Commits
Descreva a mudança feita como se estivesse prevendo o futuro: “se eu aplicar este commit, ele vai…”. Só continue a frase. Essa é a maneira infalível de escrever mensagens claras, úteis para você e para qualquer time.
⚠️Atenção
Nunca escreva commit no passado. Fuja de frases como “added suporte para espanhol”. Em vez disso, use: “add support to Spanish on uploads”.
O Poder do Presente
Mensagens no presente garantem sentido imediato e fácil leitura no histórico. Isso cria padronização e evita ambiguidades.
ℹ️Atenção
Comece sempre com um verbo no imperativo ou infinitivo em inglês. Exemplos: fix, add, remove, update, refactor.
Lendo Antes de Escrever
Antes de salvar, leia sua mensagem como: “Se eu aplicar este commit, ele vai…” e veja se soa natural. Se não, reescreva na hora.
⚠️Atenção
Evite mensagens genéricas como “changes”, “update”, “fixed bugs”. Seja específico no que será alterado no código.
Nunca Explique a Motivação no Título
A mensagem de commit não é lugar de justificar por que você fez a mudança. Guarde a motivação para o campo de descrição ou body do commit.
ℹ️Atenção
Explicação de motivos (por que fez) deixa a mensagem poluída. Foco no que muda, não no motivo.
Formato Ideal de Mensagem
Resuma o que muda em menos de 50 caracteres, sem nunca usar o passado. Exemplo: “add user avatar upload support”.
✅Dica Rápida
Verifique sempre se a mensagem responde: “ao aplicar este commit, ele vai…”
Erros Mais Comuns em Mensagens de Commit
Usar verbos no passado, títulos que explicam motivação, ou mensagens vagas são os erros clássicos — e mais prejudiciais para times e freelas.
❌Erro crítico
Mensagens no passado cortam o contexto imediato e confundem futuras revisões.
Padronização: O Diferencial para Equipes
Manter o padrão acelera a integração de novos devs e torna revisões muito mais objetivas e seguras.
✅Atenção
Padrão de mensagem reduz ruído, discussões e retrabalho na squad.
Motivação Vai no Body
Justifique por que a mudança existe na descrição do commit, nunca no título. O body é espaço para contexto, dependências e insights técnicos.
ℹ️Dica importante
Use a descrição para explicar motivação, não polua o título com informações sobre o porquê.
Exemplos de Mensagens Boas e Ruins
Ruim: “Added support for feature X”. Bom: “add X feature support in component Y”. Torne o commit autoexplicativo e imediato.
✅Exemplo bom
“remove old login api route”
❌Exemplo ruim
“removed old login api route because of new auth” — motivação foi incluída no título
Por Que Não Usar o Passado?
O passado não representa uma ação pendente, que será aplicada. Em Git, tudo é potencial mudança, por isso, escreva como se a ação fosse acontecer agora.
⚠️Atenção máxima
“Se eu aplicar este commit, ele vai [mensagem do commit]” — essa é a checagem essencial.
Como Escrever Commits Perfeitos em Equipes
Compartilhe o padrão e cobre que tudo passe pela “regra do presente”. Prefira inglês para padrões internacionais, aumentando clareza.
ℹ️Dica
Inglês padrão facilita o onboarding e evita ruídos futuros em equipes remotas.
Resolvendo Dilemas de Motivação vs Ação
Se ficou dúvida onde explicar o motivo, lembre: título = ação, body = motivação. Separe claro para facilitar manutenção.
🟣Comparação
Título: “refactor profile image upload”
Motivação no body: “Agora aceitamos webp, gif e jpg, recusamos bmp.”
Checklist Final para Commit Profissional
1. Leia a frase completa antes: “Se eu aplicar este commit, ele vai…”
2. Não justifique motivos no título.
3. Use presente ou imperativo.
4. Deixe claro o impacto da mudança.
5. Tenha padrão para o time.
🟢Checklist
Os cinco pontos acima resolvem 99% dos problemas de commit histórico.
Mais Dicas e Conteúdo Avançado
Quer turbinar suas práticas de dev e Git? No canal Dev Doido, no YouTube, mergulhe em vídeos práticos e exemplos reais. Procure por “mensagem de commit Dev Doido” e descubra o método que acelera sua carreira.
ℹ️Ir mais fundo
youtube.com/@DevDoido — Comece por lá para exemplos vencedores de commit.