Definição
Diff é a representação das diferenças entre duas versões de um conteúdo. Ele mostra linhas adicionadas, linhas removidas e trechos mantidos ao redor da alteração, o que permite ler a mudança sem abrir os arquivos completos.
O que o diff mostra
Um diff trabalha sobre dois estados comparados. Antes de interpretar o resultado, é preciso saber quais versões estão em jogo: dois commits, um commit e o estado atual dos arquivos, ou duas branches. O mesmo arquivo pode produzir leituras diferentes conforme a comparação escolhida.
git diff
git diff --stagedDiff e comportamento
O diff mostra diferenças de conteúdo, não o comportamento final do sistema. Duas linhas equivalentes podem produzir efeitos distintos, e uma alteração pequena pode afetar outro ponto. Por isso a leitura do diff acompanha testes e verificação do resultado.
Quando a leitura falha
No exemplo da regra de validação, o diff confirma a linha removida e a linha acrescentada, mas não diz o que elas fazem em execução. A falha provável é aprovar uma mudança que parece pequena e quebrar outro ponto, porque o diff não mostra dependências. A verificação roda os testes do escopo alterado e reproduz o cenário da mudança com o resultado esperado. O diff orienta onde olhar, mas a execução é o que confirma o comportamento.
Entenda o estado que o diff compara: o commitDúvidas frequentes
Perguntas frequentes sobre Diff
- O que o diff mostra?
- Ele mostra as linhas adicionadas, as linhas removidas e os trechos mantidos ao redor da alteração entre dois estados.
- O diff mostra o comportamento do sistema?
- Não. Ele mostra diferenças de conteúdo. O comportamento final depende de testes e da verificação do resultado.
- Quais estados posso comparar?
- Dois commits, um commit e o estado atual dos arquivos, ou duas branches, entre outras combinações possíveis.
Para continuar
Recursos relacionados
Documentação
Git Reference: git diff
Descreve o comando que compara versões e mostra as diferenças entre elas.
Abrir recursoDocumentação
GitHub Docs: Comparing branches in pull requests
Explica como a comparação de branches aparece em um pull request.
Abrir recursoAplicação na formação
Developer Workspace
Na Formação Developer Workspace, o diff é lido para entender o que mudou entre dois estados antes de revisar ou integrar o trabalho.
Conhecer a formaçãoFontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.