Un fichier de 50 Mo en .json suffit à figer Notepad++ et à faire planter un onglet Chrome. Pourtant, ce format minuscule fait tourner la quasi-totalité des applications web et mobiles utilisées chaque jour. Reçu en pièce jointe, exporté depuis une appli ou caché dans un dossier de configuration, un fichier JSON déroute dès qu’on l’ouvre et qu’on tombe sur une cascade d’accolades et de guillemets. Reste à savoir ce qu’il contient, à quoi il sert et pourquoi il refuse parfois de s’afficher correctement.
Ce qu’un fichier JSON contient vraiment
Un fichier JSON est un simple document texte enregistré avec l’extension .json. À l’intérieur, les données s’organisent en paires clé/valeur , comme dans {"utilisateur":"Gabin"} où la valeur de la clé « utilisateur » est « Gabin ». Quatre règles tiennent tout l’édifice : les accolades encadrent un objet, les crochets encadrent une liste, les clés et les chaînes de texte passent obligatoirement entre guillemets doubles , et un deux-points sépare chaque clé de sa valeur.
Le format accepte exactement six types de données : chaîne de caractères, nombre, booléen (true ou false, toujours en minuscules), null, objet et tableau. Piège classique : les nombres, les booléens et null ne se mettent jamais entre guillemets. Écrire "age": "30" transforme un nombre en texte et casse souvent la validation côté application, surtout dans un environnement TypeScript qui attend un type précis. Quand le fichier grossit, l’affichage prend une forme d’arborescence indentée pour rester lisible, mais cette indentation reste purement cosmétique : les espaces et les retours à la ligne n’ont aucune valeur fonctionnelle.
Pourquoi ce format se retrouve absolument partout
JSON, pour JavaScript Object Notation , sert d’abord à faire dialoguer un navigateur et un serveur. Quand une appli envoie une commande à un service de paiement et reçoit un code d’approbation en retour, les deux échanges voyagent en JSON. C’est aussi le format des fichiers de configuration que tout développeur croise quotidiennement, comme package.json ou tsconfig.json, et celui qu’utilisent les bases NoSQL orientées documents telles que MongoDB, Couchbase ou Redis pour stocker un enregistrement complet plutôt que des lignes et des colonnes rigides.
Face à son concurrent historique XML , le JSON gagne sur trois points mesurables : des fichiers plus légers, une analyse plus rapide et une compatibilité native avec JavaScript qui évite tout traitement intermédiaire. Résultat, XML se retrouve aujourd’hui cantonné aux systèmes anciens, tandis que JSON équipe les API web, les applis mobiles et les services cloud. Même des logiciels grand public s’en servent en coulisses : Firefox stocke les sauvegardes de marque-pages dans un fichier JSON, et de nombreux outils permettent d’exporter ses données personnelles dans ce format.
Comment ouvrir un fichier JSON selon sa taille
La bonne méthode dépend entièrement du poids du fichier. En dessous de quelques mégaoctets, tout est simple. Au-delà de 50 Mo, la plupart des outils classiques abandonnent.
Pour un fichier léger
La méthode la plus rapide consiste à glisser le fichier dans un navigateur (Chrome , Firefox ou Edge) : il affiche le contenu en arborescence, mais ne permet aucune modification. Pour lire et modifier, VS Code reste l’outil gratuit le plus efficace, avec coloration syntaxique et reformatage automatique en un raccourci (Maj+Alt+F pour réaligner une structure aplatie). Notepad++ fonctionne aussi, mais affiche par défaut tout le contenu sur une seule ligne illisible : il faut installer le plugin JSON Viewer via le menu Plugins pour retrouver une arborescence propre. Le Bloc-notes de Windows, lui, peine dès quelques dizaines de kilo-octets et reste à éviter.
Pour un fichier volumineux
À partir de 50 à 200 Mo, les éditeurs de bureau comme VS Code, Sublime Text ou Notepad++ chargent le fichier entier en mémoire et saturent la RAM, ce qui provoque un gel ou un plantage pur et simple. Un navigateur sur une machine équipée de 8 Go de RAM encaisse parfois jusqu’à 200 à 500 Mo, mais l’opération reste risquée. Au-delà du gigaoctet, l’outil en ligne de commande jq devient incontournable : une requête comme jq '.data[:100]' fichier.json > extrait.json permet d’extraire un échantillon exploitable sans ouvrir le monstre entier. Tenter d’importer un gros JSON dans Excel se heurte par ailleurs à un plafond strict de 1 048 576 lignes, ce qui tronque silencieusement les jeux de données trop larges.
Les erreurs qui rendent un fichier JSON illisible
La virgule traînante arrive en tête des causes de plantage. Une virgule après le dernier élément d’un tableau ou d’un objet, autorisée en JavaScript, est strictement interdite par la norme RFC 8259 qui régit le JSON. Le piège est sournois car de nombreux éditeurs colorent le fichier comme du JavaScript et restent muets : le fichier paraît correct, mais l’analyseur refuse de le lire à l’exécution.
Viennent ensuite les guillemets simples , réflexe fréquent chez les développeurs Python où 'texte' et "texte" sont équivalents, alors que JSON n’accepte que les guillemets doubles.
Même logique pour les clés sans guillemets, héritées des objets JavaScript ou des exports MongoDB : {name: "Alice"} doit devenir {"name": "Alice"}. Deux autres erreurs reviennent souvent : les caractères spéciaux non échappés, typiques des chemins Windows où C:\Users doit s’écrire C:\\Users, et les commentaires. JSON n’en accepte aucun, ni // ni /* */. Pour un fichier de configuration commenté, il faut basculer vers JSONC ou JSON5 , deux variantes qui les tolèrent.
Avant toute mise en production, passer le fichier dans un validateur pour repèrer la ligne et la colonne fautives en quelques secondes, bien plus fiablement qu’une relecture à l’œil.
Pourquoi mon fichier JSON s’affiche-t-il sur une seule ligne ? Il s’agit d’une version minifiée, où tous les espaces ont été supprimés pour réduire le poids transmis sur le réseau. Le contenu reste parfaitement valide. Un simple reformatage dans VS Code (Maj+Alt+F) ou via un formateur en ligne le réindente en arborescence lisible.
Conclusion
Trois réflexes couvrent 90 % des situations : le navigateur pour jeter un œil rapide, VS Code pour lire et corriger, et jq pour tout fichier dépassant le gigaoctet. Avant d’enregistrer un fichier modifié à la main, un passage par un validateur évite la mauvaise surprise d’une virgule de trop qui bloque toute une application. Une fois ces habitudes prises, le format perd son côté intimidant et révèle ce qu’il est vraiment : le langage commun le plus simple pour faire circuler des données entre des outils qui, sinon, ne se comprendraient pas.
