Comparar dois textos

O que conta como a mesma linha

A comparação é feita sobre uma chave, e não sobre a linha em si. Cada linha é reduzida a uma chave de acordo com as opções de ignorar que estiverem ativadas, o diff roda sobre as chaves, e o que você vê é sempre o seu texto original — então ativar “Ignorar maiúsculas e minúsculas” muda quais linhas coincidem sem alterar um único caractere do que é exibido. Há duas opções separadas de espaço em branco, e elas diferem mais do que os rótulos sugerem: uma remove os espaços das pontas da linha, e a outra primeiro reduz sequências de espaços e tabulações a um único espaço e depois remove as pontas. Nenhuma das duas elimina os espaços por completo, e a redução procura apenas espaços e tabulações literais, então um espaço ideográfico ou um espaço não separável no meio de uma linha fica intacto e continua sendo acusado como diferença.

Ignorar linhas em branco é a opção com uma consequência que ninguém menciona: as linhas em branco são removidas antes de a comparação rodar, então os números de linha ao lado do resultado contam só as linhas que sobraram e deixam de coincidir com os números de linha do seu arquivo. Com a opção desativada, eles coincidem exatamente. O destaque por palavra dentro de uma linha alterada segue a opção de ignorar maiúsculas e minúsculas e nada mais — as opções de espaço em branco não chegam até ele, então diferenças de espaçamento dentro de uma linha que mudou por outro motivo continuam pintadas como alterações.

O resultado para copiar é um diff unificado em tudo o que importa para lê-lo — os dois cabeçalhos de arquivo, linhas com sinal de menos, linhas com sinal de mais, três linhas de contexto em volta de cada mudança —, com uma exceção que vale conhecer antes de depender dele. Os marcadores de bloco não trazem intervalos de linhas, então ele serve para um relato de bug, um comentário em revisão de código ou um e-mail, e os comandos patch e git apply vão recusá-lo. Se você precisa de algo para aplicar, e não para ler, gere com o git.

Quando você precisa de outra coisa

Formatos estruturados comparam mal como linhas, e a falha é escancarada, não sutil: dois documentos JSON que só diferem na ordem das chaves, ou dois CSVs com uma coluna trocada de lugar, voltam como um paredão de mudanças que não diz nada. Compare-os com algo que entenda a estrutura — ordene as chaves dos dois arquivos JSON antes e compare os resultados, ou use o daff, que compara CSV como linhas e colunas e diz que uma coluna mudou de lugar, em vez de dizer que todas as linhas mudaram.

Duas pastas, ou dois pontos do histórico de um repositório, são assunto para o git, e não para esta página. E para textos em prosa em que os parágrafos foram requebrados, uma visão por linha é a granularidade errada — git diff --word-diff ignora onde as quebras de linha caíram e mostra só as palavras que mudaram, que é a comparação que você realmente queria quando um documento foi reformatado.