Mensagem de Commit: O Único Jeito Certo
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
Resposta direta: em “Mensagem de commit: a regra definitiva para escrever certo”, meça no seu contexto — hype e ranking não substituem eval e aceite.
Por que isso é importante
Mensagem de Commit: O Único Jeito Certo. 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.
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.
Perguntas frequentes
Por que «O Poder do Presente» importa em Mensagem de commit: a regra definitiva para escrever certo?
Extraia só o mecanismo de «O Poder do Presente»: Mensagens no presente garantem sentido imediato e fácil leitura no histórico. Isso cria padronização e evita ambiguidades.
Qual primeiro passo concreto em «Lendo Antes de Escrever»?
Checklist mental: 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. Depois revise se o resultado aparece sem você na call.
Como «Nunca Explique a Motivação no Título» se conecta ao resto do método?
Do texto: 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.
Quando «Formato Ideal de Mensagem» não deve ser a prioridade?
Resuma o que muda em menos de 50 caracteres, sem nunca usar o passado. Exemplo: “add user avatar upload support”. Em «Formato Ideal de Mensagem», o texto trata isso como prática — não como slogan.