Formattare JSON: 3 modi affidabili per renderlo leggibile e valido (Guida 2026)

Cosa fa davvero “formattare JSON”

Il JSON che arriva da un’API o da un file di log è spesso minificato: l’intero documento compresso in un’unica riga, senza spazi. Resta JSON valido, solo illeggibile. Formattare (detto anche pretty-print o abbellire) lo espande di nuovo in righe indentate così vedi la struttura: oggetti dentro oggetti, array di elementi e dove finisce ciascuno.

A volte si confonde con la validazione, e i due spesso vanno insieme. La validazione risponde a “è JSON legale?”, la formattazione a “un umano può leggerlo?”. I buoni formattatori fanno entrambe le cose in un passaggio: se il tuo JSON ha un errore di sintassi, il formattatore si ferma e indica la riga invece di produrre spazzatura in silenzio.

Metodo 1: Formattatore online gratuito (il più veloce)

Per un caso singolo — incollare una risposta API o un frammento di log — uno strumento online è la via più veloce: niente da installare, nessun codice. Scegline uno che gira interamente nel tuo browser (lato client) così i tuoi dati non lasciano mai il tuo dispositivo; è importante se il JSON contiene token, email o dati sensibili.

Incolla il tuo JSON nel formattatore (o trascina un file .json).
Clicca su Formatta: lo strumento applica l’indentazione, colora la sintassi e segnala gli errori con il numero di riga.
Copia il risultato formattato nel tuo editor, oppure usa il pulsante Minifica se ti serve la versione compatta per la produzione.

Metodo 2: Il tuo editor di codice (l’abitudine quotidiana)

Se lavori spesso con JSON, formattare dentro l’editor è una pressione di tasto. In VS Code, apri il file .json e premi Maiusc+Alt+F (Windows/Linux) o Maiusc+Opzione+F (Mac) — “Formatta documento”. VS Code può anche formattare al salvataggio se attivi Editor: Format On Save.

La maggior parte degli editor ha bisogno di un plugin per il lavoro JSON avanzato, ma la formattazione di base è integrata in VS Code, Sublime Text (tramite pacchetti) e negli IDE JetBrains.

Metodo 3: Comando da terminale (ripetibile)

Quando il JSON vive in un file e vuoi lo stesso risultato ogni volta — in uno script, in un passo di deploy o semplicemente veloce da riga di comando — una riga di comando batte qualsiasi clic.

Terminale

# Mostra data.json formattato nel terminale
python3 -m json.tool data.json

# Scrivi la versione formattata in un nuovo file
python3 -m json.tool data.json > data.pretty.json

# Stessa idea con jq, se lo hai installato
jq . data.json

python3 -m json.tool valida anche: termina con errore e numero di riga quando il file non è JSON valido, il che lo rende un controllo rapido dentro gli script.

Pretty-print vs minificato: quando usare cosa

Il JSON ben formattato è per gli umani: debug, file di configurazione modificati a mano, esempi nella documentazione. Il JSON minificato è per le macchine: risposte API, file di produzione, tutto ciò che richiede meno byte e parsing veloce.

Converti liberamente tra i due — sono gli stessi dati. Evita solo di modificare a mano la versione minificata: espandila prima, fai la tua modifica e poi minifica di nuovo se chi la riceve la vuole compatta.

Errori comuni che la formattazione rivela

Nove volte su dieci, un formattatore che “fallisce” è la cosa più utile che possa fare. Questi sono i colpevoli che continua a trovare:

Virgole finali — {"a": 1,} è illegale in JSON (vale in JavaScript). Elimina la virgola prima della parentesi di chiusura.
Virgolette singole — le stringhe JSON richiedono virgolette doppie. Cambia 'valore' in "valore".
Commenti — // e /* */ non fanno parte di JSON. Rimuovili, oppure passa il file a JSONC/JSON5 se il tuo strumento lo supporta.
Chiavi senza virgolette — {nome: "x"} deve diventare {"nome": "x"}.
Danni da copia-incolla — le virgolette tipografiche delle app di chat e dei documenti (“ ”) non sono caratteri di virgoletta validi; sostituiscile con virgolette dritte.

Prossimo passo: porta il tuo JSON formattato nel foglio di calcolo

Una volta che il tuo JSON è leggibile e valido, il passo successivo è spesso portarlo in un foglio di calcolo — ed è esattamente ciò che fa il nostro convertitore gratuito: appiattisce il tuo JSON in un CSV pulito e pronto per i fogli di calcolo in pochi secondi, con la stessa privacy senza caricamenti.

Leggi: Come convertire JSON in CSV

Guide correlate

Domande frequenti

Formattare è la stessa cosa di validare JSON?

No, ma si sovrappongono. La validazione controlla se il tuo JSON segue le regole di sintassi; la formattazione lo riscrive con indentazione e interruzioni di riga così gli umani possono leggerlo. La maggior parte dei formattatori valida prima — non formatta un documento con un errore di sintassi, per questo una formattazione fallita di solito significa JSON non valido.

La formattazione cambia i miei dati?

No. La formattazione cambia solo gli spazi bianchi: indentazione, interruzioni di riga e spazi. Chiavi, valori, ordine e tipi restano esattamente uguali — a meno che tu non attivi esplicitamente extra come l’ordinamento delle chiavi, che alcuni strumenti offrono come opzione separata.

Cosa significa “Unexpected token” quando formatto JSON?

Significa che il parser ha incontrato un carattere che non riesce a collocare — quasi sempre una virgola finale, una stringa tra virgolette singole, una chiave senza virgolette o una virgoletta tipografica incollata da un’app di chat. Il messaggio di errore di solito include una posizione; correggi quel punto, formatta di nuovo e apparirà l’errore successivo (se c’è).

Posso formattare JSON senza installare niente?

Sì. Usa un formattatore online gratuito che gira nel tuo browser, oppure la riga python3 -m json.tool se Python è già sulla tua macchina. VS Code formatta anche i file .json in modo nativo con Maiusc+Alt+F.

È sicuro incollare JSON in un formattatore online?

Di solito sì, ma scegline uno che elabora tutto nel tuo browser (lato client) — così niente viene inviato da nessuna parte. Se il JSON contiene chiavi API, dati personali o qualcosa che non invieresti via email, usa il tuo editor o il comando da terminale.

Cos’è il JSON minificato?

JSON con tutti gli spazi bianchi inutili rimossi: l’intero documento in un’unica riga. Le API e i file di produzione lo usano perché è più piccolo e si analizza un po’ più velocemente. È JSON valido — solo non pensato per occhi umani. Qualsiasi formattatore può espanderlo di nuovo nella versione leggibile.

La formattazione funziona con file JSON enormi?

Sì, con dei limiti. I formattatori nel browser gestiscono bene qualche megabyte; oltre possono bloccare la scheda. Per file grandi, formatta in locale con python3 -m json.tool o jq, che elaborano file grandi senza battere ciglio.