Git & Version Control
Monte os campos ou valide uma mensagem completa. Cada modo mantém seu próprio rascunho.
Os tipos sugeridos são comuns. Você pode digitar um tipo próprio.
Comece com Refs: #42 ou Closes #42. Linhas comuns seguintes continuam o valor anterior.
As mensagens ficam neste navegador, sem acesso ao repositório ou envio pela rede.
Estrutura Conventional Commits 1.0.0; sem regras do projeto ou limite de 50/72 caracteres. Máximo de 20.000 unidades UTF-16.
Digite uma descrição ou uma mensagem completa.
O Gerador de Conventional Commits ajuda a revisar mensagens de commit antes de levá-las ao repositório. O resumo, a explicação e os rodapés têm funções diferentes; separar os campos torna mais fácil perceber uma quebra de compatibilidade declarada por engano. O formulário e a validação guardam rascunhos separados, permitindo conferir um texto pronto sem perder o que você estava montando.
O Gerador de Conventional Commits junta tipo, escopo opcional e descrição na primeira linha. Insere linhas vazias entre as seções e mantém os parágrafos internos. Você consegue revisar o texto completo sem trocar automaticamente um tipo personalizado ou alterar as letras maiúsculas e minúsculas usadas pela equipe.
Um feat normalmente indica uma mudança minor. Com ! antes dos dois-pontos ou um rodapé de quebra válido, a intenção passa a major, independentemente do tipo. O resultado mostra essa prioridade. Ele não lê o código nem comprova que a API ficou incompatível ou que a próxima versão precisa ter um número específico.
Os tipos sugeridos são os mais comuns, mas você pode digitar outro nome. Escolha conforme a alteração real: o verificador não lê o diff e não tem como saber se fix descreve uma correção verdadeira ou se feat corresponde a uma nova funcionalidade.
Comece com Refs: #42 ou Closes #42. Uma linha comum seguinte continua o valor anterior; um novo token com separador válido inicia outra entrada. O campo dedicado declara a seção explicitamente, enquanto o corpo continua disponível para explicações em vários parágrafos.
O modo automático aguarda 350 ms após a última mudança. Ao desligá-lo, use o botão ou Ctrl/Cmd + Enter. Alterar campos, texto completo ou ! bloqueia a cópia e o download na hora, até processar novamente a entrada atual.
Monte o cabeçalho com tipo, escopo e descrição de uma linha, seguido de corpo e rodapés opcionais. A grafia é preservada; FEAT e feat têm a mesma intenção de versão. Descrições podem estar em português. A contagem do cabeçalho não transforma 50 ou 72 caracteres em um limite obrigatório.
O modo de validação confere cabeçalho, linha vazia obrigatória e rodapés reconhecíveis. Erros mostram linha e coluna, e o editor destaca a linha afetada. URLs e dois-pontos em uma frase normal não tornam o corpo automaticamente inválido. O conteúdo do formulário permanece guardado ao trocar de modo.
Use ! após o tipo ou escopo e antes dos dois-pontos. Nesse caso, um rodapé adicional é opcional. Também são aceitos BREAKING CHANGE: descrição e BREAKING-CHANGE: descrição. Esses tokens especiais precisam estar em maiúsculas. Os valores dos rodapés podem continuar em outras linhas.
Ambos são permitidos. A especificação pede que os tipos sejam interpretados sem diferenciar maiúsculas e minúsculas. Mantenha um padrão consistente na equipe. O verificador preserva a escrita original; os tokens BREAKING CHANGE e BREAKING-CHANGE são exceções e exigem maiúsculas.
Se possível, separe alterações com objetivos diferentes em commits distintos. Cada mensagem possui um único tipo aqui. O corpo pode explicar o contexto, mas selecionar feat não comprova que todas as alterações foram classificadas corretamente. Confira a compatibilidade de forma independente.
fix declara patch, feat declara minor e ! ou um rodapé de quebra válido declara major. A quebra tem prioridade sobre o tipo. O resumo mostra essa intenção sem conhecer a versão atual, versões preliminares, histórico ou política da sua ferramenta de publicação.
Em um rascunho, ajuste o tipo e faça outra verificação. Um erro como feet pode continuar válido na estrutura, pois tipos personalizados são permitidos. Alterar um commit existente é uma tarefa do repositório; esta página não executa amend, rebase ou mudanças no histórico.
A especificação deixa o comportamento de reversão para os autores das ferramentas. Você pode usar revert e um rodapé Refs para indicar os commits envolvidos. O verificador aceita essa estrutura, mas não subtrai os efeitos de alterações anteriores nem calcula a versão resultante.
Tem um formato para conferir?
Abra novamente o Gerador de Conventional Commits, compare a intenção declarada com a alteração real e exporte o resultado atual após conferir a estrutura.