{"id":617,"date":"2026-08-29T09:42:05","date_gmt":"2026-08-29T12:42:05","guid":{"rendered":"https:\/\/fabiobrandao.net.br\/blog\/?p=617"},"modified":"2026-08-29T09:48:32","modified_gmt":"2026-08-29T12:48:32","slug":"conventional-commits-o-guia-pratico-para-padronizar-seus-commits","status":"publish","type":"post","link":"https:\/\/fabiobrandao.net.br\/blog\/gestao-e-planejamento\/conventional-commits-o-guia-pratico-para-padronizar-seus-commits\/","title":{"rendered":"Conventional Commits: O Guia pr\u00e1tico para padronizar seus commits"},"content":{"rendered":"\n

O Conventional Commits<\/strong> \u00e9 uma conven\u00e7\u00e3o simples para mensagens de commit<\/em>. Ele fornece um conjunto leve de regras para criar um hist\u00f3rico de commits expl\u00edcito e f\u00e1cil de ler, al\u00e9m de facilitar a automa\u00e7\u00e3o de ferramentas (como gera\u00e7\u00e3o autom\u00e1tica de changelogs<\/em> e controle de versionamento sem\u00e2ntico).<\/p>\n\n\n\n

Para conferir a especifica\u00e7\u00e3o oficial completa, acesse: conventionalcommits.org<\/a><\/p>\n\n\n\n

Estrutura B\u00e1sica de um Commit<\/h2>\n\n\n\n

A mensagem de commit deve ser estruturada da seguinte forma:<\/p>\n\n\n\n

<tipo>(<escopo opcional>): <descri\u00e7\u00e3o curta>\n<corpo opcional>\n<rodap\u00e9 opcional>\n\n<\/code><\/pre>\n\n\n\n
Tipos Principais de Commit<\/h2>\n\n\n\n
Tipo<\/strong><\/td>Quando Usar<\/strong><\/td><\/tr><\/thead>
feat<\/code><\/td>Adiciona uma nova funcionalidade ao projeto<\/td><\/tr>
fix<\/code><\/td>Corrige um bug<\/em> ou erro no sistema<\/td><\/tr>
docs<\/code><\/td>Mudan\u00e7as exclusivamente na documenta\u00e7\u00e3o<\/td><\/tr>
style<\/code><\/td>Mudan\u00e7as de formata\u00e7\u00e3o (espa\u00e7amentos, ponto e v\u00edrgula, etc.) que n\u00e3o afetam a l\u00f3gica<\/td><\/tr>
refactor<\/code><\/td>Refatora\u00e7\u00e3o de c\u00f3digo sem alterar o comportamento funcional<\/td><\/tr>
perf<\/code><\/td>Mudan\u00e7a de c\u00f3digo focada em melhoria de performance<\/td><\/tr>
test<\/code><\/td>Adi\u00e7\u00e3o ou ajuste de testes automatizados<\/td><\/tr>
build<\/code><\/td>Modifica\u00e7\u00f5es no sistema de build ou depend\u00eancias externas<\/td><\/tr>
ci<\/code><\/td>Altera\u00e7\u00f5es em arquivos\/configura\u00e7\u00f5es de Integra\u00e7\u00e3o Cont\u00ednua (CI)<\/td><\/tr>
chore<\/code><\/td>Tarefas de manuten\u00e7\u00e3o diversa (n\u00e3o afetam o c\u00f3digo-fonte em src<\/code> nem testes)<\/td><\/tr>
revert<\/code><\/td>Reverte um commit feito anteriormente<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Exemplos Simples<\/p>\n\n\n\n
git commit -m \"feat: adiciona login via Google\"\ngit commit -m \"fix: corrige erro de null pointer no checkout\"\ngit commit -m \"docs: atualiza README com instru\u00e7\u00f5es de instala\u00e7\u00e3o\"\ngit commit -m \"refactor: simplifica l\u00f3gica de valida\u00e7\u00e3o de CPF\"\ngit commit -m \"test: adiciona testes para servi\u00e7o de pagamento\"\ngit commit -m \"chore: atualiza depend\u00eancias do projeto\"\n\n<\/code><\/pre>\n\n\n\n
Adicionando Escopo<\/h3>\n\n\n\n
O escopo indica a parte espec\u00edfica do c\u00f3digo que foi afetada e vem entre par\u00eanteses logo ap\u00f3s o tipo:<\/p>\n\n\n\n
git commit -m \"feat(auth): adiciona suporte a login com Google\"\ngit commit -m \"fix(api): corrige timeout na rota de usu\u00e1rios\"\ngit commit -m \"style(header): ajusta espa\u00e7amento do menu\"\n\n<\/code><\/pre>\n\n\n\n
Indicando Breaking Changes (Mudan\u00e7as Incompat\u00edveis)<\/h2>\n\n\n\n
Existem duas formas de indicar mudan\u00e7as que quebram a compatibilidade da aplica\u00e7\u00e3o com vers\u00f5es anteriores:<\/p>\n\n\n\n
Op\u00e7\u00e3o 1: Adicionando o caractere !<\/code><\/h3>\n\n\n\n
git commit -m \"feat(api)!: remove endpoint \/v1\/users deprecated\"\n\n<\/code><\/pre>\n\n\n\n
Op\u00e7\u00e3o 2: Utilizando o rodap\u00e9 BREAKING CHANGE<\/code><\/h3>\n\n\n\n
git commit -m \"feat(api): renomeia par\u00e2metro de busca\nBREAKING CHANGE: o par\u00e2metro 'q' foi renomeado para 'query'\"\n\n<\/code><\/pre>\n\n\n\n
Commit Completo (com Corpo e Rodap\u00e9)<\/h2>\n\n\n\n
Quando a mudan\u00e7a for mais complexa, utilize o corpo para contextualizar a altera\u00e7\u00e3o:<\/p>\n\n\n\n
git commit -m \"fix(payment): corrige c\u00e1lculo de desconto em pedidos grandes \nO desconto n\u00e3o estava sendo aplicado corretamente quando o valor do pedido ultrapassava R$ 1000. Fixes #123\"\n\n<\/code><\/pre>\n\n\n\n
Referenciando Issues<\/h3>\n\n\n\n
git commit -m \"feat(cart): adiciona bot\u00e3o de remover item Closes #45\"\n\n<\/code><\/pre>\n\n\n\n
Rela\u00e7\u00e3o com Versionamento Sem\u00e2ntico<\/h2>\n\n\n\n
Seguir esse padr\u00e3o se conecta diretamente ao Semantic Versioning (MAJOR.MINOR.PATCH)<\/strong>:<\/p>\n\n\n\n
    \n
  • fix <\/strong>– Incrementa o PATCH (ex: 1.0.0 => 1.0.1)<\/li>\n\n\n\n
  • feat <\/strong>– Incrementa o MINOR (ex: 1.0.0 => 1.1.0)<\/li>\n\n\n\n
  • BREAKING CHANGE<\/strong> (ou !) – Incrementa o MAJOR (ex: 1.0.0 => 2.0.0)<\/li>\n<\/ul>\n\n\n\n
    Boas Pr\u00e1ticas<\/h2>\n\n\n\n
      \n
    • Modo Imperativo:<\/strong> Escreva a descri\u00e7\u00e3o curta no imperativo (ex: “adiciona”<\/em> em vez de “adicionado”<\/em> ou “adicionando”<\/em>).<\/li>\n\n\n\n
    • Tamanho Ideal:<\/strong> Mantenha a primeira linha com no m\u00e1ximo 50 a 72 caracteres<\/strong>.<\/li>\n\n\n\n
    • Sem Ponto Final:<\/strong> N\u00e3o finalize o t\u00edtulo\/descri\u00e7\u00e3o curta com ponto (.<\/code>).<\/li>\n\n\n\n
    • Foco do Corpo:<\/strong> Use o corpo para explicar o o qu\u00ea<\/strong> e o porqu\u00ea<\/strong> da mudan\u00e7a, e n\u00e3o o como<\/em>.<\/li>\n\n\n\n
    • Padroniza\u00e7\u00e3o do Time:<\/strong> Seja consistente com os tipos e escopos adotados no projeto (se necess\u00e1rio, liste-os na documenta\u00e7\u00e3o da equipe).<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
      O Conventional Commits \u00e9 uma conven\u00e7\u00e3o simples para mensagens de commit. Ele fornece um conjunto leve de regras para criar um hist\u00f3rico de commits expl\u00edcito e f\u00e1cil de ler, al\u00e9m… <\/p>\n","protected":false},"author":1,"featured_media":616,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"footnotes":""},"categories":[83],"tags":[107,108,106],"class_list":["post-617","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-gestao-e-planejamento","tag-commit","tag-conventional","tag-git"],"_links":{"self":[{"href":"https:\/\/fabiobrandao.net.br\/blog\/wp-json\/wp\/v2\/posts\/617","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fabiobrandao.net.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fabiobrandao.net.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fabiobrandao.net.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fabiobrandao.net.br\/blog\/wp-json\/wp\/v2\/comments?post=617"}],"version-history":[{"count":13,"href":"https:\/\/fabiobrandao.net.br\/blog\/wp-json\/wp\/v2\/posts\/617\/revisions"}],"predecessor-version":[{"id":633,"href":"https:\/\/fabiobrandao.net.br\/blog\/wp-json\/wp\/v2\/posts\/617\/revisions\/633"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/fabiobrandao.net.br\/blog\/wp-json\/wp\/v2\/media\/616"}],"wp:attachment":[{"href":"https:\/\/fabiobrandao.net.br\/blog\/wp-json\/wp\/v2\/media?parent=617"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fabiobrandao.net.br\/blog\/wp-json\/wp\/v2\/categories?post=617"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fabiobrandao.net.br\/blog\/wp-json\/wp\/v2\/tags?post=617"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}