54. Melhores práticas para commits e mensagens de commit

Melhores Práticas para Commits e Mensagens de Commit

O controle de versão é uma parte essencial do desenvolvimento de software moderno, e o Git, juntamente com o GitHub, é uma das ferramentas mais populares para gerenciamento de versões. Uma parte fundamental do uso eficaz do Git é a habilidade de criar commits claros e informativos. Abaixo estão as melhores práticas para fazer commits e escrever mensagens de commit que ajudam a manter um histórico de projeto claro e útil.

1. Faça Commits Pequenos e Focados

Commits devem ser atômicos, significando que cada commit deve representar uma única unidade lógica de mudança. Isso facilita a revisão de código, o teste de mudanças isoladas e a localização de bugs. Se você estiver trabalhando em várias tarefas ao mesmo tempo, divida-as em commits separados.

2. Escreva Mensagens de Commit Claras e Descritivas

Cada commit deve ter uma mensagem que descreva claramente o que foi alterado e por que. Uma boa mensagem de commit permite que outros desenvolvedores, e até mesmo você no futuro, entendam rapidamente o propósito da mudança sem ter que analisar o código em detalhes.

3. Use o Presente Imperativo

O Git em si usa o presente imperativo em suas mensagens geradas automaticamente - por exemplo, "Merge branch 'x'". Siga este estilo ao escrever suas próprias mensagens de commit. Comece com um verbo no presente imperativo, como "Add", "Update", "Remove", etc. Isso cria uma série de instruções que descrevem o que fazer o commit irá realizar se aplicado ao código.

4. Primeira Linha como um Resumo

A primeira linha da sua mensagem de commit deve ser uma breve descrição da mudança, limitada a 50 caracteres se possível. Isso age como um título para o commit. Se necessário, deixe uma linha em branco após o resumo e continue com uma descrição mais detalhada em parágrafos subsequentes.

5. Use o Corpo da Mensagem quando Necessário

Para mudanças complexas, uma linha não será suficiente para descrever o que foi feito e por que. Nesses casos, após o resumo, adicione um corpo detalhado à mensagem de commit. Explique o contexto da mudança e compare com o comportamento anterior do código.

6. Evite Mensagens Genéricas

Mensagens como "fix bug" ou "improve code" não fornecem informações úteis. Seja específico sobre qual bug foi corrigido ou como o código foi melhorado.

7. Referencie Issues e Pull Requests

Se o seu commit está relacionado a uma issue ou pull request no GitHub, inclua a referência na mensagem de commit. Isso cria um link automático entre o commit e a issue/pull request, facilitando o rastreamento de mudanças específicas.

8. Evite Jargões e Termos Técnicos Obscuros

Embora seu público seja principalmente outros desenvolvedores, evite usar jargões ou termos técnicos que não sejam amplamente compreendidos. Isso garante que as mensagens de commit sejam acessíveis a todos os membros da equipe, independentemente de seu nível técnico.

9. Revise seus Commits Antes de Publicá-los

Antes de fazer push dos seus commits para o repositório remoto, revise-os. Verifique se cada commit é atômico e se as mensagens são claras e informativas. Isso pode envolver reorganizar, dividir ou combinar commits.

10. Consistência nas Mensagens de Commit

Mantenha um estilo consistente em suas mensagens de commit. Se você está trabalhando em equipe, é útil ter um guia de estilo que todos sigam. Isso pode incluir a estrutura das mensagens, o uso de tags (como [FEATURE], [FIX], [REFACTOR]), e outros padrões que a equipe concordou em seguir.

11. Use Ferramentas e Hooks do Git

O Git fornece hooks que podem ser usados para impor padrões de mensagem de commit ou para executar verificações antes que os commits sejam aceitos. Use essas ferramentas para ajudar a manter a qualidade das suas mensagens de commit.

12. Eduque sua Equipe

Se você está liderando uma equipe ou trabalhando em um projeto colaborativo, eduque seus colegas sobre a importância de bons commits e mensagens de commit. Um repositório bem gerenciado é um esforço de equipe.

Conclusão

Commits e mensagens de commit são mais do que apenas um registro técnico; eles são a história do seu projeto. Seguir estas melhores práticas ajudará a tornar essa história clara, útil e acessível para todos aqueles que trabalham com o código. Além disso, um histórico de commit bem mantido pode ser uma ferramenta valiosa para revisão de código, depuração e colaboração.

Próxima página do Ebook Gratuito:

55Revisão de código e code ownership

4 minutos