Por que o Git recusa alguns envios
O force push é um envio ao repositório remoto que permite atualizar uma referência mesmo quando o novo histórico não prolonga o anterior. Uma referência de branch aponta para seu commit mais recente. No avanço chamado fast-forward, o commit remoto anterior permanece como ancestral do novo. Depois de um rebase, essa relação pode não existir.
O envio com --force permite substituir a referência por um histórico reescrito. Commits que estavam acessíveis pela branch podem desaparecer do histórico percorrido a partir dela, inclusive trabalho de outro colaborador. Como a opção afeta as referências selecionadas para o envio, você precisa conferir o destino da atualização.
Um commit novo chegou durante o rebase
Em um exemplo didático, você reescreve uma branch que conhecia no commit A. Durante o rebase, outro colaborador envia o commit B ao mesmo destino. Um push com --force pode mover a branch para a sua versão reescrita sem preservar B naquele histórico.
O --force-with-lease acrescenta uma comparação: a atualização só é aceita se a referência remota ainda tiver o valor esperado. Quando a expectativa é A e o remoto está em B, o envio é recusado. O manual do git push documenta a forma --force-with-lease=refs/heads/nome:commit-esperado para indicar esse valor explicitamente.
Sem um valor explícito, a comparação usa a referência local de acompanhamento do remoto. Um git fetch automático pode atualizar essa referência para B sem que você tenha revisado o commit. Essa condição reduz a proteção oferecida pela expectativa implícita. Mesmo com o lease aceito, o servidor pode recusar o envio por suas permissões ou proteções da branch.
Dúvidas frequentes
Perguntas frequentes sobre force push
- O force push apaga todo o repositório remoto?
- A atualização afeta as referências selecionadas para o envio. Ela pode retirar commits do histórico alcançado pela branch, sem necessariamente afetar outras branches.
- O servidor pode recusar um push forçado?
- Sim. Permissões, hooks e proteções da branch podem rejeitar a atualização. A opção usada no cliente não revoga essas restrições do servidor.
- O force-with-lease confirma que o código está correto?
- Ele compara o valor remoto com a expectativa definida para a referência. Essa comparação não verifica o comportamento do código nem confirma que os colaboradores aceitaram a reescrita.
Para continuar
Recursos relacionados
Documentação
Git: atualizações remotas e force-with-lease
Explica as opções de envio forçado, a comparação feita pelo lease e o efeito de atualizações automáticas das referências locais.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Sessão prática com orientação técnica para revisar o histórico e acompanhar alterações no repositório.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O trabalho com repositórios compartilhados exige compreender os efeitos de reescrever commits e atualizar branches remotas.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.