Guia · 2026-10-18T00:00:00.000Z

Como ler um diff de texto sem se perder

O que o texto riscado e o texto marcado querem dizer, e o que uma comparação de palavras não sabe sobre a sua intenção.

O diff coloca duas versões lado a lado na leitura: o que saiu fica riscado, o que entrou fica marcado. Não é o histórico de um repositório. É o que você precisa quando o cliente manda “a versão final” em cima de um parágrafo que você já tinha fechado.

Comece pelo modo palavra se os dois textos são o mesmo bloco com edição miúda. O alinhamento procura o maior pedaço igual e trata o resto como saída ou entrada. Espaço é peça. Uma quebra de linha aparece. Se alguém só mudou “não” por “sim”, você vê as duas palavras, não uma frase inteira reescrita. Esse é o ganho.

Passe para o modo linha quando o texto é longo, quando é lista, ou quando a página avisa que caiu nesse modo sozinha. Acima de algumas centenas de tokens, a conta palavra a palavra fica pesada para a aba. Linha ainda mostra que o terceiro item mudou, sem tentar alinhar cada vírgula.

Reordenação engana. Se você troca o primeiro parágrafo com o segundo, o diff muitas vezes mostra um bloco apagado e outro inserido, em vez de uma seta de “movido”. Não existe movimento no algoritmo desta página. Quando a mancha vermelha e a verde parecem o mesmo texto, desconfie de ordem, não de conteúdo.

O que o diff não sabe é intenção. Uma negação removida no meio da cláusula muda o contrato e ocupa dois caracteres na tela. Leia o que saiu, depois o que entrou, e só então a frase que sobrou. Se você lê só o texto novo, o risco já fez o trabalho de sumir.

Não cole senha, documento ou dado de cliente aqui para “ver a diferença” num computador compartilhado. A comparação fica na aba, mas a aba também fica no histórico local do navegador se você não limpar. Para código de verdade, use a ferramenta do repositório, que guarda autor e contexto de arquivo. Esta página é para prosa.