Escrever boas mensagens de commit
O você do futuro vai agradecer pelas suas mensagens
⏱ Estim. ~8 min
01 · Ler
Uma boa mensagem de commit é um presente para o você do futuro (e para seu time). Ela deve explicar por que você fez a alteração, não só o que mudou. Mensagens claras tornam o histórico do git realmente útil.
💡 Imagine assimEscrever boas mensagens de commit é como colocar legendas no verso das fotos. "Festa de aniversário de 3 anos na casa da vovó" ajuda muito. "Foto" não ajuda em nada. Meses depois, essas legendas são a única forma de você lembrar o que cada snapshot retrata.
Pontos-chave
- Boas mensagens explicam o porquê: 'Fix login timeout for slow connections'
- Mensagens ruins são vagas: 'fixed stuff', 'update', 'asdf'
- A primeira linha deve ser curta (até 50 caracteres) e usar imperativo: 'Add', 'Fix', 'Update'
02 · Prática de terminal
Você tem um projeto de blog com HTML e CSS. Vamos praticar escrever boas mensagens de commit com o fluxo completo.
(Esta seção é interativa — ative o JavaScript para usar.)
03 · Prática de terminal
Faça stage de todos os arquivos para o seu primeiro commit.
(Esta seção é interativa — ative o JavaScript para usar.)
04 · Prática de terminal
O seu primeiro commit deve descrever o que o projeto traz. Não escreva só 'first commit' — seja específico sobre o seu ponto de partida.
(Esta seção é interativa — ative o JavaScript para usar.)
05 · Quiz
Qual destas mensagens de commit segue as boas práticas?
- "fixed stuff"
- "Add user login validation for email format"
- "update"
- "changes"
06 · Prática de terminal
Agora vamos adicionar uma feature nova no seu blog — uma barra de navegação.
(Esta seção é interativa — ative o JavaScript para usar.)
07 · Prática de terminal
Stage do arquivo alterado.
(Esta seção é interativa — ative o JavaScript para usar.)
08 · Prática de terminal
Escreva uma mensagem de commit para esta alteração. Descreva o que você adicionou, não escreva só 'update'. Bons exemplos: 'Add navigation bar to blog', 'Add nav links for Home, About, Contact'.
(Esta seção é interativa — ative o JavaScript para usar.)
09 · Quiz
Qual destas mensagens de commit segue melhor as convenções profissionais?
- "updated stuff"
- "asdfjkl"
- "Fix password reset for expired tokens"
- "I changed the login page to fix a bug where users couldn't log in when their session expired after 24 hours"
Outras lições deste capítulo
⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.
※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.