📋
← Retour aux guides

Impression JSON : comment formater JSON pour la lisibilité

· Tags: json, pretty-print, json-formatter, json-indentation, developer-tools

Qu'est-ce que l'impression JSON ?

L'impression JSON est le processus qui consiste à prendre des données JSON brutes et compactes (minifiées) et à les reformater avec une indentation, des sauts de ligne et des espaces appropriés afin de les rendre lisibles par un humain. Un document JSON imprimé utilise une indentation cohérente et une mise en forme structurelle claire qui révèle la hiérarchie des objets et des tableaux imbriqués.

Comparez ces deux représentations des mêmes données :

Minifié (difficile à lire) :

{"users":[{"id":1,"name":"Alice","roles":["admin","editor"]},{"id":2,"name":"Bob","roles":["viewer"]}],"total":2}

Imprimé (facile à lire) :

{
  "users": [
    {
      "id": 1,
      "name": "Alice",
      "roles": ["admin", "editor"]
    },
    {
      "id": 2,
      "name": "Bob",
      "roles": ["viewer"]
    }
  ],
  "total": 2
}

Impression contre minification JSON

Le choix entre JSON imprimé et JSON minifié dépend du cas d'utilisation :

| Aspect | Impression | Minification | |--------|-------------|----------| | Lisibilité | Élevée -- structure claire | Faible -- toutes les données sur une seule ligne | | Taille de fichier | Plus grande (plus d'espaces) | Plus petite (aucun espace superflu) | | Transfert réseau | Plus lent pour les grosses charges utiles | Plus rapide, moins de bande passante | | Débogage | Idéal pour le développement | Peu pratique pour l'inspection | | Utilisation en production | Rarement utilisée | Standard pour les réponses API |

Les API de production servent généralement du JSON minifié pour réduire la bande passante, tandis que les développeurs impriment le JSON pendant le développement et le débogage.

Styles d'indentation

La plupart des formateurs prennent en charge deux styles d'indentation courants :

Indentation de 2 espaces (la plus courante)

{
  "name": "Alice",
  "age": 30,
  "address": {
    "city": "New York"
  }
}

Recommandé pour : les projets JavaScript/TypeScript, le développement web moderne et la plupart des usages généraux.

Indentation de 4 espaces

{
    "name": "Alice",
    "age": 30,
    "address": {
        "city": "New York"
    }
}

Recommandé pour : les projets Python (style PEP 8) et les équipes qui préfèrent une indentation plus large pour plus de clarté.

Indentation par tabulation

Certains développeurs préfèrent une indentation basée sur les tabulations, en particulier dans les flux de travail axés sur l'accessibilité où les utilisateurs ajustent la largeur des tabulations dans leur éditeur.

Choisir la bonne indentation

La plupart des équipes standardisent sur 2 espaces car cela équilibre la lisibilité avec l'efficacité de l'espace horizontal. L'écosystème JavaScript (Node.js, React, Vue) utilise massivement une indentation de 2 espaces. Si vous travaillez dans un environnement fortement orienté Python, une indentation de 4 espaces peut sembler plus naturelle. La clé est la cohérence -- choisissez un style et imposez-le dans tout votre projet avec un outil comme Prettier ou EditorConfig.

Impression JSON dans différents langages de programmation

JavaScript / Node.js

const formatted = JSON.stringify(data, null, 2);
console.log(formatted);

Python

import json
formatted = json.dumps(data, indent=2)
print(formatted)

Java

import com.fasterxml.jackson.databind.ObjectMapper;
ObjectMapper mapper = new ObjectMapper();
String formatted = mapper.writerWithDefaultPrettyPrinter()
    .writeValueAsString(data);

Go

import "encoding/json"
formatted, _ := json.MarshalIndent(data, "", "  ")
fmt.Println(string(formatted))

Ruby

require 'json'
puts JSON.pretty_generate(data)

Comment imprimer du JSON

Utiliser un formateur JSON en ligne

La méthode la plus rapide consiste à utiliser un formateur JSON en ligne gratuit -- collez votre JSON et obtenez instantanément une sortie formatée avec coloration syntaxique et détection d'erreurs.

Utiliser des outils en ligne de commande

Avec jq (le plus populaire) :

cat file.json | jq .

Avec Python :

python -m json.tool file.json

Avec Node.js :

node -e "const d = require('./file.json'); console.log(JSON.stringify(d, null, 2));"

Outils de développement des navigateurs

Tous les navigateurs majeurs formatent automatiquement les réponses JSON dans leurs onglets Réseau :

  • Chrome DevTools : l'onglet Réseau imprime automatiquement les réponses JSON
  • Firefox Developer Tools : les réponses JSON sont affichées avec des vues arborescentes repliables
  • Web Inspector de Safari : l'aperçu JSON inclut un formatage automatique

Plugins IDE pour le formatage JSON

VS Code

VS Code dispose d'une excellente prise en charge JSON intégrée. Utilisez Shift+Alt+F (Windows/Linux) ou Shift+Option+F (macOS) pour formater n'importe quel fichier JSON. Des extensions supplémentaires améliorent l'expérience :

  • Prettier -- Formate JSON, JSONC et de nombreux autres langages de manière cohérente
  • JSON Tools -- Triez, minifiez et formatez le JSON avec des raccourcis clavier
  • JavaScript Booster -- Fonctionnalités avancées de manipulation JSON

IDE JetBrains (IntelliJ, WebStorm, PyCharm)

  • Formateur intégré : Ctrl+Alt+L (Windows/Linux) ou Cmd+Option+L (macOS)
  • Validation et formatage automatiques du JSON lors du collage

Vim / Neovim

" Format JSON in place
:%!jq .

Options avancées de formatage JSON

Les formateurs JSON modernes offrent plus qu'une simple indentation :

  • Tri des clés -- Triez les clés d'objet par ordre alphabétique pour une sortie cohérente
  • Coloration syntaxique -- Clés, chaînes, nombres et booléens codés en couleur
  • Arborescences repliables -- Développez et repliez les structures imbriquées pour une navigation plus facile
  • Numéros de ligne -- Référencez des emplacements spécifiques pendant le débogage
  • Surlignage des erreurs -- Marquez visuellement les erreurs de syntaxe avec des messages détaillés

Bonnes pratiques pour la lisibilité JSON

  1. Validez toujours avant de formater -- Un formateur ne peut pas corriger un JSON invalide. Utilisez d'abord un validateur JSON pour détecter les erreurs de syntaxe.
  2. Établissez une norme d'équipe -- Convenez de l'indentation (2 espaces est le standard du secteur) et imposez-la avec Prettier ou un linter.
  3. Gardez l'imbrication peu profonde -- Un JSON profondément imbriqué (4 niveaux ou plus) est difficile à lire quel que soit le formatage. Envisagez de restructurer lorsque c'est possible.
  4. Utilisez des clés significatives -- Des noms de clés descriptifs et concis améliorent la lisibilité plus que n'importe quel formateur.
  5. Ajoutez des sauts de ligne finaux -- Terminez les fichiers JSON par un caractère de nouvelle ligne pour vous conformer aux normes POSIX et éviter le bruit dans les diffs.

Essayez notre outil d'impression JSON en ligne gratuit pour formater et embellir instantanément vos données JSON avec une indentation personnalisable et une coloration syntaxique.