Ir para o conteúdo
Promovaweb

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
  1. Uma proposta de merge entre duas branches
  2. Do push ao merge
  3. O que a revisão registra
  4. Proteção da branch base
  5. Três métodos de merge

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:

  1. Branch enviada

    git push -u origin minha-branch

    Os commits novos ficam numa branch própria, separada da main.

  2. Proposta aberta

    gh pr create --fill

    O pull request mostra a comparação dos arquivos e a descrição da mudança.

  3. Checagens

    gh pr checks

    Os workflows testam o resultado simulado do merge e publicam o status.

  4. Revisão

    gh pr review --approve

    A revisão comenta, aprova ou devolve a alteração com mudanças a fazer.

  5. Merge

    gh pr merge --squash

    Com as exigências da base cumpridas, os commits entram na main.

O caminho de um pull request no GitHub: a branch enviada vira proposta, as checagens e a revisão conferem a alteração e o merge leva os commits para a branch base.

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.

Resposta da revisãoO que ela comunicaEfeito no merge
CommentUma observação geral sobre a mudança.Não aprova nem segura o merge.
ApproveA alteração está pronta para entrar.Soma no número mínimo de aprovações da base protegida.
Request changesHá ajustes a fazer pelo autor.Com revisão obrigatória na base, segura o merge até a aprovação do revisor ou a dispensa da revisão.

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 main mostra 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.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.