Fluxo de depuração com diff de texto

Quando uma comparação parece ruidosa ou confusa, trate revisão de diff como depuração: reduza variáveis, compare a menor amostra útil e escolha a ferramenta certa.

Fluxo prático

1. Cole o texto original à esquerda e o modificado à direita.
2. Comece com diff linha a linha lado a lado.
3. Leia o resumo de mudanças: adicionadas, removidas, alteradas, inalteradas.
4. Se poucas linhas mudaram, mude para destaque em nível de palavra.
5. Se espaço ou capitalização criam mudanças falsas, ative opções de ignorar.
6. Se colou os lados na ordem errada, troque-os.
7. Copie o resumo do diff para nota, ticket ou comentário de revisão.

Quando ignorar espaços ou maiúsculas

Ative ignorar espaços quando:

• Um arquivo tem espaços no fim
• Indentação mudou mas valores não
• Copiar/colar introduziu linhas em branco extras nas bordas

Ative ignorar maiúsculas quando:

• Rótulos de ambiente diferem só por caso
• Nomes de header ou valores tipo enum devem ser equivalentes
• Você quer focar no conteúdo semântico, não na formatação

Não ignore espaços/maiúsculas quando bytes exatos importam, como entradas HMAC, payloads assinados ou caminhos sensíveis a caso.

Diff de texto vs diff JSON

Escolha de forma intencional:

• Diff de texto: configs, logs, arquivos env, saída curl, texto misto, payloads parciais
• Diff JSON: objetos JSON parseados em que caminhos de campo e estrutura aninhada importam

Se diff JSON reporta muitas mudanças mas diff de texto mostra só uma linha, o problema pode ser ordem de chaves ou formatação — não dados de negócio.

Sinais comuns de falha

• Tudo parece mudado: verifique ordem de chaves, espaços ou se comparou arquivos não relacionados.
• Nada parece mudado mas o comportamento difere: compare amostra maior ou outra camada (headers, env, corpo da resposta).
• Diff grande demais para o navegador: corte para a seção relevante primeiro.

Conclusão

Boa revisão de diff é disciplinada: menor amostra, view correta, modo de destaque certo, opções de ignorar certas e ferramenta de comparação certa para o formato dos dados.

O Comparador de Diff de Texto foi feito para este fluxo: processamento local, views lado a lado/unificada, destaques em nível de palavra, opções de ignorar, trocar lados e copiar em um workspace.