Sobre como comparar branches nas pull requests
As pull requests exibem diffs para comparar as alterações feitas no branch de tópico com o branch base com o qual você deseja fazer merge.
Neste artigo
- Opções de exibição de diff
- Comparações de diff do Git de três pontos e dois pontos
- Motivos pelos quais os diffs não serão exibidos
- Leia mais
Observação: ao criar a pull request, é possível alterar o branch base com o qual você está comparando suas alterações. Para obter mais informações, consulte "Criar uma pull request".
É possível exibir alterações propostas em uma pull request na guia Files changed (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 aparecem em ordem alfabética na guia Files changed (Arquivos alterados). As adições aos arquivos aparecem em verde e são precedidas por um sinal de +, enquanto o conteúdo que foi removido aparece em vermelho e é precedido por um sinal de -.
Opções de exibição de diff
Dica: se estiver com dificuldades para entender o contexto de uma alteração, você poderá clicar em View (Exibir) na guia Files changed (Arquivos alterados) para ver o arquivo todo com as alterações propostas.
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 uma pull request extensa, é possível filtrar o diff para mostrar apenas os tipos de arquivo selecionados ou ocultar arquivos excluídos. Para obter mais informações, consulte "Filtrar aquivos em uma pull request por tipo de arquivo".
Comparações de diff do Git de três pontos e dois pontos
Por padrão, as pull requests no GitHub mostram um diff de três pontos ou uma comparação entre a versão mais recente do branch de tópico e o commit onde o branch de tópico foi sincronizado pela última vez com o branch base.
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, consulte Glossário do Git para "committish" no book site do Pro Git.
For example, this URL uses the shortened seven-character SHA codes to compare commits c3a414e and faf7c6f: https://github.com/github/linguist/compare/c3a414e..faf7c6f.
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 alterações, consulte "Opções de diff do Git" no book site do Pro Git.
Motivos pelos quais os diffs não serão exibidos
- Você excedeu o limite total de arquivos ou de determinados tipos de arquivo. Para obter mais informações, consulte "Limites para exibição de conteúdo e diffs em um repositório".
- Seu arquivo corresponde a uma regra no arquivo .gitattributes do repositório para impedir esse arquivo de ser exibido por padrão. Para obter mais informações, consulte "Personalizar como os arquivos alterados aparecem no GitHub".