Comparer deux fichiers JSON sans faux écarts ni piège

Comparer deux JSON

texte ou structure ?

Comparer deux fichiers JSON paraît trivial, jusqu’au moment où deux documents qui contiennent exactement les mêmes données s’affichent comme différents. Le malentendu vient d’une confusion entre deux opérations qui n’ont pas le même but. La comparaison textuelle traite le fichier comme une suite de caractères : elle signale la moindre différence d’espace ou de retour à la ligne. La comparaison structurelle, elle, lit le JSON comme ce qu’il est — un ensemble de clés, de valeurs et de tableaux — et ne compare que le sens des données.

Pour la plupart des besoins réels, c’est la comparaison structurelle qui compte. Savoir si deux réponses d’API contiennent les mêmes champs, repérer la valeur qui a changé entre deux exports, vérifier qu’un fichier de configuration n’a pas dévié : dans tous ces cas, l’ordre d’écriture et la mise en forme n’ont aucune importance. Choisir le bon type de comparaison, c’est déjà éviter la moitié des fausses alertes.

Pourquoi un simple diff de texte se trompe

Un outil de diff classique, pensé pour le code, compare ligne par ligne. Appliqué à du JSON, il bute sur plusieurs particularités du format. Les clés d’un objet ne suivent pas d’ordre fixe : deux programmes peuvent écrire les mêmes champs dans un ordre différent, et le diff textuel y verra des dizaines de lignes modifiées alors que rien n’a changé au fond.

L’indentation et les espaces jouent le même rôle. Un fichier compacté sur une seule ligne et le même fichier joliment indenté sont identiques pour les données, mais radicalement différents en texte. S’ajoutent des détails sournois : une virgule finale, des guillemets autour d’un nombre qui le transforment en chaîne, un booléen écrit en majuscules. Tout cela passe inaperçu à l’œil mais fausse une comparaison naïve. Sur du JSON, mieux vaut un outil qui comprend la structure qu’un diff aveugle au format.

Choisir sa méthode selon le contexte

Trois familles d’outils couvrent presque tous les cas. Elles ne s’opposent pas : on passe de l’une à l’autre selon la fréquence du besoin et la sensibilité des données.

Comparer dans un éditeur de code

Quand les fichiers sont déjà sur votre machine, l’éditeur de code fait souvent l’affaire sans rien installer. La plupart des éditeurs modernes proposent une comparaison de deux fichiers, qui ouvre une vue côte à côte avec les écarts surlignés. C’est l’option naturelle pour travailler en local et comparer au passage des fichiers qui ne sont pas du JSON.

Pour que cette comparaison reste lisible, un préalable change tout : formater les deux fichiers de la même façon avant de les confronter. Un éditeur sait reformater un JSON en un raccourci. Une fois les deux documents indentés à l’identique, la vue de comparaison ne montre plus que les différences réelles. Des extensions dédiées vont plus loin avec une comparaison consciente de la structure, utile sur de gros fichiers.

Bien préparer ses fichiers avant de comparer

La préparation résout à elle seule la majorité des faux écarts, quel que soit l’outil choisi. Trois gestes suffisent dans la plupart des cas, et ils valent pour les trois méthodes.

Avec ces précautions, n’importe quelle méthode devient fiable. Le choix entre comparateur en ligne, éditeur de code et ligne de commande ne dépend alors que du contexte. La règle qui les relie toutes tient en une phrase : sur du JSON, on compare des données, pas des caractères.