Voltar para o blog

Conventional Commits: Padronização que Faz Diferença

Entenda o padrão Conventional Commits e como ele pode melhorar drasticamente a qualidade do seu histórico Git e automatizar processos.

Conventional Commits: Padronização que Faz Diferença

Conventional Commits é uma especificação que traz padronização, legibilidade e até automação para seu workflow Git.

O que são Conventional Commits?

Conventional Commits é uma convenção sobre mensagens de commit:

<tipo>[escopo opcional]: <descrição>

[corpo opcional]

[rodapé opcional]

Tipos de Commits

feat: Nova funcionalidade

feat: adiciona filtro de busca avançada

fix: Correção de bug

fix: corrige cálculo de frete

docs: Apenas documentação

docs: atualiza README

refactor: Refatoração sem mudar comportamento

refactor: extrai lógica para service

Benefícios Práticos

Geração Automática de CHANGELOG

Com commits padronizados, ferramentas podem gerar changelogs automaticamente.

Versionamento Semântico Automático

  • feat → aumenta MINOR (1.0.0 → 1.1.0)
  • fix → aumenta PATCH (1.0.0 → 1.0.1)
  • BREAKING CHANGE → aumenta MAJOR (1.0.0 → 2.0.0)

Ferramentas

Commitizen

npm install -g commitizen
git cz  # ao invés de git commit

Commitlint

Garanta que todos os commits seguem o padrão.

Conventional Commits transforma commits de simples checkpoints em documentação viva do projeto!