Sobre como comparar branches nas pull requests

Você pode ver as alterações propostas em uma solicitação de pull na guia Arquivos alterados.

Em vez de exibir os commits em si, você pode ver as alterações propostas como elas aparecerão nos arquivos assim que a pull request passar pelo merge. Os arquivos são exibidos em ordem alfabética na guia Arquivos alterados. As adições aos arquivos são exibidas em verde e são precedidas por um sinal +, enquanto o conteúdo que foi removido é exibido em vermelho e é precedido por um sinal -.

Opções de exibição de diff

Há várias opções de exibição de um diff:

• A exibição unificada mostra conteúdo atualizado e existente juntos em uma exibição linear.
• A exibição dividida mostra conteúdo antigo em um lado e novo conteúdo do outro lado.
• A exibição de diff avançado mostra uma visualização da aparência das alterações depois que a pull request passar por merge.
• A exibição da origem mostra as alterações na origem sem a formatação da exibição de diff avançado.

Também é possível optar por ignorar alterações de espaço em branco para obter uma exibição mais precisa das alterações importantes em uma pull request.

Para simplificar a revisão das alterações em um pull request extenso, é possível filtrar o diff para mostrar apenas os tipos de arquivo selecionados, mostrar arquivos dos quais você é CODEOWNER, ocultar arquivos que você já visualizou ou ocultar arquivos excluídos. Para saber mais, confira Filtrar arquivos em uma pull request.

Você também pode usar a visualização de diferenças para ver quais dependências você está introduzindo ou alterando com sua solicitação pull e se as versões das dependências contêm vulnerabilidades de segurança. Para saber mais, confira Revisão de alterações de dependências em um pull request.

Motivos pelos quais as diferenças não serão exibidas

• Você excedeu o limite total de arquivos ou de determinados tipos de arquivo. Para saber mais, confira Limites de repositório.
• Seu arquivo corresponde a uma regra no arquivo .gitattributes do repositório para impedir que esse arquivo seja exibido por padrão. Para saber mais, confira Personalizando como os arquivos alterados aparecem no GitHub.

Comparações de diff do Git de três pontos e dois pontos

Há dois métodos de comparação para o comando git diff; dois pontos (git diff A..B) e três pontos (git diff A...B). As solicitações de pull em GitHub mostram uma diferença de três pontos.

Comparação Git de três pontos

A comparação de três pontos mostra a diferença entre a confirmação comum mais recente dos dois branches (base de mesclagem) e a versão mais recente do branch do tópico.

Comparação Git de dois pontos

A comparação de dois pontos mostra a diferença entre o estado mais recente da ramificação base (por exemplo, main) e a versão mais recente da ramificação do tópico.

Para ver duas referências de committish em uma comparação de diff de dois pontos no GitHub, você pode editar o URL da página "Comparing changes" (Comparar alterações) do seu repositório. Para obter mais informações, confira o "committish" no Glossário do Git do site do livro Pro Git.

Por exemplo, essa URL usa os códigos SHA reduzidos para comparar os commits f75c570 e 3391dcc: https://github.com/github-linguist/linguist/compare/f75c570..3391dcc.

Um diff de dois pontos compara duas referências de committish do Git, como SHAs ou IDs de objeto (OIDs, Object IDs), diretamente entre si. No GitHub, as referências de committish do Git em uma comparação de diff de dois pontos devem ser enviadas por push ao mesmo repositório ou para suas bifurcações.

Se desejar simular um diff de dois pontos em uma pull request e ver uma comparação entre as versões mais recentes de cada branch, você poderá fazer merge do branch base no branch de tópico, o que atualiza o último ancestral comum entre seus branches.

Para obter mais informações sobre os comandos do Git para comparar as alterações, confira Opções de comparação do Git no site do livro Pro Git.

Sobre a comparação de três pontos no GitHub

Como a comparação de três pontos compara com a base da mesclagem, ela se concentra no “que uma solicitação pull introduz”.

Quando você usa uma comparação de dois pontos, ela muda quando o branch base é atualizado, mesmo que você não tenha feito nenhuma alteração no branch do tópico. Além disso, uma comparação de dois pontos se concentra no branch base. Isso significa que tudo o que você adicionar será considerado como ausente do branch base, como se fosse uma exclusão, e o contrário também é verdadeiro. Como resultado, as alterações que o ramo de tópico introduz tornam-se ambíguas.

Por outro lado, comparando os branches usando a comparação de três pontos, as alterações no branch de tópico estarão sempre na comparação se o branch base for atualizado, pois ela mostra todas as alterações desde que os branches divergiram.

Mesclar com frequência

Para evitar ficar confuso, mescle a ramificação base (por exemplo, main) em sua ramificação de tópico com frequência. Ao mesclar o branch base, as comparações de dois pontos e três pontos mostradas são as mesmas. Recomendamos mesclar um pull request o mais rápido possível. Isso incentiva os colaboradores a fazer com que as solicitações de pull sejam menores, o que é recomendado de modo geral.

Leitura adicional

•         [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)
  

•         [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)