📋
← Torna alle guide

Pretty Print JSON: Come Formattare il JSON per la Leggibilità

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

Cos'è il Pretty Print JSON?

Il pretty print JSON è il processo che prende dati JSON grezzi e compatti (minificati) e li riformatta con un'indentazione, delle interruzioni di riga e una spaziatura adeguate per renderli leggibili da un essere umano. Un documento JSON formattato con pretty print usa un'indentazione coerente e una formattazione strutturale chiara che rivela la gerarchia di oggetti e array annidati.

Confronta queste due rappresentazioni degli stessi dati:

Minificato (difficile da leggere):

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

Pretty Print (facile da leggere):

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

Pretty Print vs JSON Minificato

La scelta tra JSON formattato con pretty print e JSON minificato dipende dal caso d'uso:

| Aspetto | Pretty Print | Minificato | |--------|-------------|----------| | Leggibilità | Alta -- struttura chiara | Bassa -- tutti i dati su una riga | | Dimensione del file | Maggiore (più spazi bianchi) | Minore (nessun overhead di spazi bianchi) | | Trasferimento di rete | Più lento per payload di grandi dimensioni | Più veloce, meno banda | | Debug | Ideale per lo sviluppo | Impraticabile per l'ispezione | | Uso in produzione | Usato raramente | Standard per le risposte API |

Le API di produzione servono tipicamente JSON minificato per ridurre la banda, mentre gli sviluppatori eseguono il pretty print del JSON durante lo sviluppo e il debug.

Stili di indentazione

La maggior parte dei formattatori supporta due stili di indentazione comuni:

Indentazione a 2 spazi (la più comune)

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

Consigliata per: progetti JavaScript/TypeScript, sviluppo web moderno e la maggior parte degli usi generali.

Indentazione a 4 spazi

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

Consigliata per: progetti Python (stile PEP 8) e team che preferiscono un'indentazione più ampia per chiarezza.

Indentazione con tab

Alcuni sviluppatori preferiscono l'indentazione basata su tab, in particolare nei flussi di lavoro incentrati sull'accessibilità in cui gli utenti regolano la larghezza dei tab nel loro editor.

Scegliere l'indentazione giusta

La maggior parte dei team si standardizza su 2 spazi perché bilancia la leggibilità con l'efficienza dello spazio orizzontale. L'ecosistema JavaScript (Node.js, React, Vue) usa in modo schiacciante l'indentazione a 2 spazi. Se lavori in un ambiente dominato da Python, l'indentazione a 4 spazi può sembrare più naturale. La chiave è la coerenza -- scegli uno stile e applicalo in tutto il progetto con uno strumento come Prettier o EditorConfig.

Pretty Print JSON in diversi linguaggi di programmazione

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)

Come eseguire il pretty print del JSON

Usando un formattatore JSON online

Il metodo più rapido è usare un formattatore JSON online gratuito -- incolla il tuo JSON e ottieni un output istantaneo e formattato con evidenziazione della sintassi e rilevamento degli errori.

Usando gli strumenti da riga di comando

Con jq (il più popolare):

cat file.json | jq .

Con Python:

python -m json.tool file.json

Con Node.js:

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

Strumenti di sviluppo del browser

Tutti i principali browser formattano automaticamente le risposte JSON nelle loro schede Network:

  • Chrome DevTools: la scheda Network esegue automaticamente il pretty print delle risposte JSON
  • Firefox Developer Tools: le risposte JSON vengono visualizzate con viste ad albero comprimibili
  • Safari Web Inspector: l'anteprima JSON include la formattazione automatica

Plugin IDE per la formattazione JSON

VS Code

VS Code ha un eccellente supporto JSON integrato. Usa Shift+Alt+F (Windows/Linux) o Shift+Option+F (macOS) per formattare qualsiasi file JSON. Ulteriori estensioni migliorano l'esperienza:

  • Prettier -- Formatta JSON, JSONC e molti altri linguaggi in modo coerente
  • JSON Tools -- Ordina, minifica e formatta il JSON con scorciatoie da tastiera
  • JavaScript Booster -- Funzionalità avanzate di manipolazione JSON

IDE JetBrains (IntelliJ, WebStorm, PyCharm)

  • Formattatore integrato: Ctrl+Alt+L (Windows/Linux) o Cmd+Option+L (macOS)
  • Validazione e formattazione automatica del JSON al momento dell'incolla

Vim / Neovim

" Format JSON in place
:%!jq .

Opzioni avanzate di formattazione JSON

I formattatori JSON moderni offrono più della semplice indentazione di base:

  • Ordinamento delle chiavi -- Ordina alfabeticamente le chiavi degli oggetti per un output coerente
  • Evidenziazione della sintassi -- Chiavi, stringhe, numeri e booleani codificati a colori
  • Alberi comprimibili -- Espandi e comprimi le strutture annidate per una navigazione più semplice
  • Numeri di riga -- Fai riferimento a posizioni specifiche durante il debug
  • Evidenziazione degli errori -- Contrassegna visivamente gli errori di sintassi con messaggi dettagliati

Buone pratiche per la leggibilità del JSON

  1. Valida sempre prima di formattare -- Un formattatore non può correggere un JSON non valido. Usa prima un validatore JSON per individuare gli errori di sintassi.
  2. Stabilisci uno standard di team -- Concorda l'indentazione (2 spazi è lo standard di settore) e applicala con Prettier o un linter.
  3. Mantieni l'annidamento poco profondo -- Il JSON profondamente annidato (4+ livelli) è difficile da leggere indipendentemente dalla formattazione. Considera una ristrutturazione quando possibile.
  4. Usa chiavi significative -- Nomi di chiave descrittivi e concisi migliorano la leggibilità più di qualsiasi formattatore.
  5. Aggiungi ritorni a capo finali -- Termina i file JSON con un carattere di nuova riga per rispettare gli standard POSIX ed evitare rumore nei diff.

Prova il nostro strumento di pretty print JSON online gratuito per formattare e abbellire istantaneamente i tuoi dati JSON con indentazione personalizzabile ed evidenziazione della sintassi.