Quando o Git chama o pre-commit
Um hook de pré-commit é um programa que o Git executa durante a tentativa de criar um commit, antes de obter a mensagem e gravar esse commit. Ele pode rodar um verificador de formatação e devolver ao Git um código que permite continuar ou interrompe a tentativa.
O Git procura o programa chamado pre-commit no diretório de hooks do repositório, que pode ser alterado pela configuração core.hooksPath. O programa precisa estar habilitado para execução. Ter o verificador instalado no projeto não faz o Git chamá-lo automaticamente.
Uma formatação recusada pelo hook
Num exemplo didático, o script consulta os arquivos preparados para o commit e executa o verificador de formatação sobre esse conteúdo. Ao encontrar uma formatação inválida, o script retorna o código 1. O Git interrompe aquela tentativa sem criar o commit.
Você pode corrigir o arquivo indicado, preparar a alteração novamente e repetir a tentativa. A saída do verificador precisa identificar o arquivo e o problema encontrado para orientar a correção.
O Git chama o pre-commit sem argumentos, por isso o script precisa escolher o que será examinado. Um verificador que lê o arquivo do diretório de trabalho pode analisar uma versão diferente do conteúdo preparado para o commit quando apenas parte das alterações foi selecionada.
Instalação local e verificações no servidor
A opção --no-verify permite ignorar o pre-commit. A presença desse hook na sua máquina não comprova que as mesmas checagens rodaram nas alterações enviadas por outro colaborador.
Você pode executar as verificações também num fluxo de integração contínua no servidor. Assim, as alterações recebidas são examinadas pela configuração daquele ambiente mesmo quando a checagem local foi ignorada.
Dúvidas frequentes
Perguntas frequentes sobre hook de pré-commit
- O hook recebe automaticamente a lista dos arquivos preparados?
- O Git chama o pre-commit sem argumentos. O script precisa obter os arquivos que pretende examinar e escolher se verifica o conteúdo preparado ou os arquivos do diretório de trabalho.
- Como o retorno do hook afeta o commit?
- Um código diferente de zero interrompe aquela tentativa de criação. O retorno zero permite que o Git continue, mas outras verificações ou falhas ainda podem impedir o commit.
- O hook substitui as verificações da integração contínua?
- A execução local depende da instalação e pode ser ignorada com --no-verify. As verificações da integração contínua precisam rodar também no servidor para conferir as alterações recebidas.
Para continuar
Recursos relacionados
Documentação
Git: hooks e pre-commit
Documenta a localização dos hooks, a exigência de execução e o comportamento do pre-commit.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Orientação técnica ao vivo para revisar a configuração das checagens locais e investigar uma tentativa de commit recusada.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
As checagens locais ajudam a encontrar falhas de formatação e testes durante a preparação das alterações no Git.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.