Pull requests e revisão de código
O pull request é a proposta de levar os commits de uma branch para outra, como a main, com a comparação dos arquivos alterados e um espaço de revisão no GitHub. Enquanto ele fica aberto, os workflows rodam a cada push na branch e os revisores comentam linha a linha, por isso o código chega à branch principal com a revisão e o resultado dos testes registrados no próprio pull request.
Ficha e sumário da página
- Referência técnica
- GitHub CLI v2.104.0
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Uma proposta de merge entre duas branches
A documentação do GitHub define o pull request como uma proposta de merge de alterações de código num projeto. Ele liga duas branches. A head guarda os seus commits novos, enquanto a base, como a main, vai receber esses commits. O pull request mostra a diferença entre as duas, arquivo por arquivo. Na mesma página ficam registrados os fatos em volta dessa diferença: comentários, aprovações e o resultado das checagens automáticas.
Para avaliar a proposta sem mexer na base, o GitHub cria referências temporárias: uma aponta para a head e outra, quando o merge é possível, para o resultado simulado do merge. Quando os workflows do Actions e as integrações testam esse resultado simulado, o teste confere o código como ele vai ficar na main, com as alterações que outros pull requests já levaram para lá.
O pull request também pode abrir como rascunho. Um draft não aceita merge e não chama automaticamente os donos do código para revisar. Quando você marca o draft como pronto para revisão, o GitHub chama os code owners definidos no arquivo CODEOWNERS. A volta para rascunho fica disponível a qualquer momento.
Do push ao merge
O caminho de um pull request tem as mesmas etapas em qualquer repositório, com um registro de cada etapa na página dele. A diferença entre projetos fica nas exigências configuradas na branch base, como o número de aprovações e as checagens obrigatórias:
Branch enviada
git push -u origin minha-branchOs commits novos ficam numa branch própria, separada da main.
Proposta aberta
gh pr create --fillO pull request mostra a comparação dos arquivos e a descrição da mudança.
Checagens
gh pr checksOs workflows testam o resultado simulado do merge e publicam o status.
Revisão
gh pr review --approveA revisão comenta, aprova ou devolve a alteração com mudanças a fazer.
Merge
gh pr merge --squashCom as exigências da base cumpridas, os commits entram na main.
O cabeçalho do pull request e a caixa de merge mostram o que ainda falta. A aba Checks lista os testes, os builds e as outras validações automáticas. Cada push novo na head roda as checagens de novo, então o status mostrado corresponde ao último commit da branch.
O que a revisão registra
A revisão no GitHub termina numa de três respostas. O comentário deixa uma observação geral sem aprovar nem devolver. A aprovação diz que a alteração está pronta para o merge. A solicitação de mudanças aponta o que o autor precisa corrigir para a proposta seguir. Com permissão de leitura no repositório, você já comenta e revisa um pull request. A solicitação formal de revisão a um colega exige permissão de escrita.
A revisão fica valendo como documento do projeto. Meses depois, quando você investiga por que uma função mudou, o git blame leva ao commit e o commit leva ao pull request, com a discussão que justificou a alteração. Para esse caminho levar a uma resposta, a descrição do pull request precisa explicar o motivo da mudança além de listar os arquivos.
Proteção da branch base
Por padrão, um colaborador com escrita faz o merge de qualquer pull request. A proteção de branch muda isso: ela exige um número mínimo de aprovações de colaboradores com escrita ou de code owners. Ela também exige que as checagens obrigatórias terminem com status de sucesso, ignorado ou neutro. No modo estrito, que é o padrão das checagens obrigatórias, a branch precisa estar atualizada com a base para o merge seguir.
Na proteção clássica, só uma configuração vale por vez para cada branch, por isso fica difícil saber qual delas se aplica quando várias apontam para a mesma branch. Os rulesets configuram exigências parecidas sem essa limitação. Uma proteção clássica já configurada pode ser convertida em ruleset pelas configurações do repositório.
Três métodos de merge
O GitHub oferece três formas de levar os commits para a base, cada uma com um histórico diferente na main. Todas exigem escrita no repositório e precisam estar habilitadas nas configurações:
Merge commit
- Leva todos os commits da branch e cria um commit de merge com
--no-ff. - Preserva os commits originais, com autor, data e SHA.
- A
mainmostra onde cada branch entrou. - Fica de fora quando a base exige histórico linear.
Squash e rebase
- O squash junta os commits da proposta num único commit na base.
- O rebase reaplica cada commit na base, sem commit de merge e com SHA novo.
- Os dois produzem um histórico linear na
main. - O squash descarta o SHA, a data e a autoria dos commits originais.
O squash transforma cada pull request num commit com a descrição da mudança. Esse formato facilita montar o changelog da versão seguinte a partir do histórico da main. O custo do squash aparece quando você continua trabalhando na mesma branch depois do merge: os commits antigos voltam a aparecer no próximo pull request entre as mesmas branches, com os mesmos conflitos para resolver de novo. Para uma branch de vida longa, a documentação do GitHub sugere o merge commit ou o rebase da branch antes de abrir o pull request seguinte.
O próximo assunto é o que roda dentro das checagens: os workflows do GitHub Actions, onde ficam, o que os dispara e as máquinas que os executam, na página GitHub Actions.