Notice: This page requires JavaScript to function properly.
Please enable JavaScript in your browser settings or update your browser.
Aprenda Mensagens de Commit | Introdução ao Git
Git Essentials

Mensagens de Commit

Deslize para mostrar o menu

Por que as Mensagens de Commit São Importantes

Mensagens de commit são essenciais para compreender o histórico de um projeto. Mensagens claras e significativas ajudam colaboradores, desenvolvedores futuros e você a entender o propósito e o contexto de cada alteração. Um histórico de commits bem estruturado melhora a colaboração, simplifica a depuração e facilita o rastreamento de mudanças específicas na linha do tempo do projeto.

Anatomia de uma Boa Mensagem de Commit

1. Concisão e Clareza

Uma mensagem de commit deve ser concisa e direta. Ela deve transmitir claramente o propósito do commit em uma única linha. Evite ambiguidade e forneça informações suficientes para entender a alteração sem precisar olhar o código propriamente dito.

Bad: "Fixed a bug"
Good: "Fix issue with user authentication in login form"

2. Separe o Assunto do Corpo

Se mais detalhes forem necessários, separe o assunto do corpo da mensagem de commit com uma linha em branco. O assunto deve resumir a alteração, e o corpo pode fornecer contexto adicional, razões para a mudança e qualquer informação relevante.

Veja um exemplo de mensagem de commit desse tipo:

Subject: "Add validation for user email input"

Body: "This commit introduces email format validation to ensure
that users provide a valid email address when registering. It
helps improve the overall data integrity of the system."

Neste caso, execute o comando git commit sem a flag -m:

git commit

O editor de texto padrão do Git será aberto, onde é possível escrever uma mensagem de commit detalhada. Em seguida, é necessário salvar e sair do editor de texto de forma apropriada.

Vamos realizar outro commit em nosso repositório:

Aqui está o comando utilizado para modificar o arquivo de texto:

echo "Git is the most popular VCS in the world used by millions of developers since it allows efficient collaboration via committing, reverting and merging changes. Besides, Git is free and open source and can be easily installed on Windows, macOS, Linux and all Unix-based platforms." >> test.txt

A mensagem de commit é a seguinte:

Subject: "Add description of Git"
  
Body: "This commit introduces brief description 
of Git and highlights its key features. It also 
states the reasons for the widespread popularity 
of Git."

Se você não conseguir editar o arquivo, pressione a tecla i. Isso garante que você entre no modo de edição. Novamente, para salvar as alterações e sair do Vim, pressione a tecla Escape e duas letras Z maiúsculas.

Note
Nota

Se você utiliza um editor de texto padrão diferente no terminal (além do Vim) e encontrar dificuldades, é fácil encontrar na internet como salvar alterações e sair dele.

3. Use o Modo Imperativo

Escreva mensagens de commit no modo imperativo, transmitindo uma orientação para a alteração. Inicie o assunto com um verbo, como "Corrigir", "Adicionar" ou "Atualizar".

Bad: "Fixed the issue with the login form"
Good: "Fix issue with user authentication in login form"
question mark

Qual abordagem melhor demonstra concisão e clareza em uma mensagem de commit?

Selecione a resposta correta

Tudo estava claro?

Como podemos melhorá-lo?

Obrigado pelo seu feedback!

Seção 1. Capítulo 10

Pergunte à IA

expand

Pergunte à IA

ChatGPT

Pergunte o que quiser ou experimente uma das perguntas sugeridas para iniciar nosso bate-papo

Seção 1. Capítulo 10
some-alt