Convertitore da TOML a JSON

Che cos'è TOML e perché convertirlo in JSON?

// Convert TOML to JSON in Node.js using the smol-toml library
import { parse } from 'smol-toml';

const toml = `
[package]
name = "my-app"
version = "1.0.0"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
`;

const data = parse(toml);
const json = JSON.stringify(data, null, 2);

console.log(json);
// {
//   "package": { "name": "my-app", "version": "1.0.0" },
//   "dependencies": {
//     "serde": { "version": "1.0", "features": ["derive"] }
//   }
// }

Caratteristiche principali

Esempi

[package]
name = "my-app"
version = "1.0.0"
edition = "2021"
authors = ["Jane Doe <jane@example.com>"]

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

[dev-dependencies]
criterion = "0.5"

[[bin]]
name = "my-app"
path = "src/main.rs"

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "my-package"
version = "0.3.1"
requires-python = ">=3.10"
dependencies = [
  "requests>=2.31",
  "pydantic>=2.0"
]

[project.optional-dependencies]
dev = ["pytest>=8.0", "ruff>=0.4"]

[tool.ruff]
line-length = 100

[build]
command = "npm run build"
publish = "dist"

[build.environment]
NODE_VERSION = "20"

[[redirects]]
from = "/old-path"
to = "/new-path"
status = 301
force = true

[[headers]]
for = "/*"

[headers.values]
X-Frame-Options = "DENY"

baseURL = "https://example.org"
languageCode = "en-us"
title = "My Hugo Site"
theme = "ananke"

[params]
description = "A static site built with Hugo"
mainSections = ["posts", "docs"]

[[menu.main]]
name = "Blog"
url = "/posts/"
weight = 1

[[menu.main]]
name = "About"
url = "/about/"
weight = 2

edition = "2021"
max_width = 100
hard_tabs = false
tab_spaces = 4
newline_style = "Unix"
use_small_heuristics = "Default"
reorder_imports = true
reorder_modules = true

title = "Deployment Log"
last_deployed = 1979-05-27T07:32:00Z
release_date = 1979-05-27
maintenance_window = 02:00:00

[[servers]]
name = "alpha"
ip = "10.0.0.1"
ports = [8001, 8002]

[[servers]]
name = "beta"
ip = "10.0.0.2"
ports = [9001]

Come si usa

1. 1

   Incolla il tuo TOML

   Inserisci o incolla il tuo TOML nel campo di input qui sopra. Puoi anche fare clic su 'Carica esempio' per provare un vero Cargo.toml, pyproject.toml o una configurazione di deploy.

2. 2

   Guarda l'output JSON in tempo reale

   Il JSON compare istantaneamente nel pannello di output. Regola l'opzione Rientro (2 o 4 spazi) per adattarla al formato di destinazione. Date, tabelle e array di tabelle vengono gestiti automaticamente.

3. 3

   Copia o scarica

   Fai clic su Copia per copiare il JSON negli appunti o su Scarica per salvarlo come file .json pronto per il tuo programma, la tua API o i tuoi strumenti.

Errori comuni con TOML

name = my-app

name = "my-app"

name = "a"
name = "b"

name = "a"
alt_name = "b"

released = 2026-7-2

released = 2026-07-02

ports = [8001, 8002

ports = [8001, 8002]

snowflake = 1420070400000000000

snowflake = "1420070400000000000"

[servers]
name = "a"
[servers]
name = "b"

[[servers]]
name = "a"
[[servers]]
name = "b"

Casi d'uso comuni

Metadati Cargo di Rust

Converti Cargo.toml in JSON per costruire dashboard delle dipendenze, verificare versioni e feature dei crate o passare i dati del manifest a script e CI che si aspettano JSON anziché TOML.

Configurazione di progetto Python

Converti pyproject.toml in JSON per ispezionare i metadati di progetto PEP 621, estrarre elenchi di dipendenze o alimentare strumenti che leggono la configurazione di packaging in modo programmatico.

Ispezione della configurazione di deploy

Converti netlify.toml, foundry.toml o altre configurazioni di piattaforma in JSON per verificare redirect, header e impostazioni di build, o per generare una configurazione equivalente per un'altra piattaforma.

Migrazione del formato di configurazione

Converti la configurazione di applicazione TOML in JSON quando passi a un sistema che preferisce JSON, o come passaggio intermedio prima di trasformarla ulteriormente con strumenti JSON come jq.

Impostazioni di siti statici

Converti il config.toml di Hugo in JSON per migrare le impostazioni del sito, confrontare la configurazione tra ambienti o costruire un'interfaccia di impostazioni basata su JSON.

Input per API e script

Trasforma il TOML scritto dalle persone in JSON che un'API REST, una funzione serverless o uno script di automazione può consumare direttamente, collegando la configurazione leggibile e l'input per le macchine.

Dettagli tecnici

Analisi TOML 1.0.0 tramite smol-toml

Il TOML viene analizzato con la libreria smol-toml, un parser a dipendenza zero pienamente conforme a TOML 1.0.0. Gestisce correttamente tabelle annidate, chiavi con notazione a punti, tabelle inline, array di tabelle, stringhe multi-riga e tutti e quattro i tipi di data-ora, e segnala gli errori di analisi con la posizione di riga e colonna.

Date-ora senza perdita e gestione sicura degli interi

Le date-ora di TOML vengono serializzate in stringhe JSON che conservano il loro tipo esatto (offset date-time, local date-time, data locale, ora locale). Gli interi oltre l'intervallo sicuro di JavaScript (2^53 - 1) vengono promossi a BigInt durante l'analisi, poi convertiti nel numero JSON più vicino con un avviso di precisione, così il TOML valido non fallisce mai la conversione.

100% basato sul browser — nessun caricamento, nessun server

Tutta l'elaborazione avviene nel motore JavaScript del tuo browser. Nessun dato viene trasmesso in alcun momento. Gli input più grandi di 200 KB passano dalla modalità live a quella manuale (un clic esplicito su Converti) per mantenere l'interfaccia reattiva.

Buone pratiche

Memorizza gli interi molto grandi come stringhe

Se il tuo TOML ha interi oltre 2^53 - 1 (Snowflake ID, timestamp in nanosecondi, contatori grandi), racchiudili tra virgolette come stringhe prima di convertire. I numeri JSON nel browser non possono contenerli esattamente e lo strumento ti avviserà quando deve arrotondare.

Preferisci il rientro di 2 spazi per l'output JSON

Il rientro di due spazi è la convenzione più diffusa per JSON e produce un output pulito e leggibile che si integra bene con la maggior parte dei formattatori e degli strumenti di diff. Riserva il rientro di 4 spazi a quando una linea guida di stile lo richiede.

Valida l'output JSON prima di usarlo

Dopo la conversione, se prevedi di modificare a mano il JSON o di passarlo a qualcosa di rigoroso, controllalo con il nostro Formattatore JSON per confermare che sia valido e formattato in modo coerente.

Conserva separatamente i commenti TOML

JSON non ha una sintassi per i commenti, quindi i commenti # di TOML vengono eliminati durante la conversione. Se i commenti sono documentazione importante, conserva il TOML originale nel controllo di versione accanto al JSON generato.

Usa array di tabelle per le sezioni ripetute

Quando hai più sezioni simili (server, redirect, bin), scrivile come array di tabelle ([[section]]) invece di ripetere [section]. Si convertono in un array JSON di oggetti pulito invece di causare un errore di tabella duplicata.

Domande frequenti