Trouver ce qui a changé : Un guide du Diff de texte

Quelque chose a cassé. Le fichier de config a l'air pareil. Sauf qu'il ne l'est pas—quelque part dans ces 500 lignes, un caractère a changé.

Bonne chance pour le trouver manuellement.

Les outils Diff existent exactement pour ça. Compare deux versions, vois ce qui a changé. Le temps de débogage passe d'heures à secondes.

Quand Diff te sauve

Fichiers de configuration. Le déploiement a cassé ? Compare la config fonctionnelle à l'actuelle.

Revues de code. Qu'est-ce qui a vraiment changé dans cette pull request ?

Réponses API. Pourquoi le même endpoint retourne des données différentes maintenant ?

Versions de documents. Qu'est-ce que le client a changé dans le contrat ?

Lire la sortie Diff

La plupart des outils diff montrent :

• Lignes retirées en rouge (préfixées par -)
• Lignes ajoutées en vert (préfixées par +)
• Lignes de contexte inchangées, montrant le contenu environnant

 function process(data) {
-  return data.toLowerCase();
+  return data.toLowerCase().trim();
 }

Une ligne a changé. L'ancienne version ne trimait pas, la nouvelle oui.

Side-by-Side vs Unifié

Diff unifié montre les changements inline. Compact, bon pour les petits changements.

Side-by-side montre les anciennes et nouvelles versions côte à côte. Mieux pour comprendre les changements plus larges.

Choisis en fonction de ce que tu compares.

Diff au niveau caractère

Le diff de ligne montre quelles lignes ont changé. Le diff de caractère montre exactement quels caractères dans ces lignes.

Pour déboguer la configuration, le niveau caractère aide à trouver :

• Espaces supplémentaires
• Mauvais guillemets (' vs ")
• Caractères invisibles
• Différences de casse

Conseils pratiques

Strip whitespace quand ça n'a pas d'importance. Les espaces de fin et différentes fins de ligne causent du bruit.

Ignore la casse quand approprié. Parfois "TRUE" et "true" sont pareils.

Utilise le contexte. Voir les lignes environnantes aide à comprendre les changements.

Diff les données structurées soigneusement. JSON et XML devraient être formatés identiquement avant comparaison, ou les différences de reformatage masqueront les vrais changements.

Cas d'usage courants

Déboguer les différences d'environnement. Compare la config staging à production. La différence est généralement le bug.

Suivre les changements dans le temps. Sauvegarde les versions avant et après changements. Diff te dit exactement ce que tu as fait.

Valider les migrations. Compare les dumps de base de données avant et après. Les différences inattendues signifient bugs de migration.

Revue de code. Vois ce qui change vraiment, pas ce que l'auteur prétend avoir changé.

Quand le diff de ligne ne suffit pas

Fichiers binaires. Les outils diff fonctionnent sur le texte. Images, PDFs et exécutables nécessitent des outils spécialisés.

Sémantiquement identique mais différemment formaté. Deux fichiers JSON avec les mêmes données mais formatage différent montreront beaucoup de différences. Normalise d'abord.

Code déplacé. Le diff standard montre suppression et addition séparément. Les outils avancés peuvent détecter les déplacements.

---

Diff est un outil de débogage sous-estimé. Quand quelque chose "a l'air pareil" mais se comporte différemment, arrête de deviner et compare. La différence est là—tu as juste besoin de la voir.