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.