Formatage JSON et indentation : bonnes pratiques tabs vs espaces

2024-06-14

Le formatage n'est pas qu'esthetique : une indentation coherente facilite les revues et reduit le bruit de merge. Voici comment choisir et quand compresser.

Espaces dans la specification JSON

Les espaces et retours ligne sont insignifiants pour le parseur ; le style releve des humains et de l'equipe.

Tabs vs espaces

Preferez les espaces pour une coherence inter-editeurs et des diffs plus propres. Les tabs sont autorises mais rares dans les exemples JSON publics.

2 vs 4 espaces

Deux espaces dominent en front-end et Node ; quatre apparaissent dans certaines configs Java/Python. Choisissez une convention par depot.

{
  "user": {
    "name": "Alice",
    "roles": ["admin", "editor"]
  }
}

Quand utiliser le pretty-print

Debug, documentation et edition manuelle : formatez avant revue pour que le diff montre les vrais changements.

Quand minifier

Transport en production et reduction de taille. Gardez une version lisible ailleurs ; n'editez pas du JSON minifie a la main.

Conseils d'equipe

Utilisez .editorconfig pour les fichiers json. Parse check optionnel en CI. Exemples de docs en 2 espaces ; logs eventuellement minifies.