Convertitore da JSON a struct Rust

Cos'è la conversione da JSON a Rust?

Esempi

{"id":101,"name":"Ada Lovelace","email":"ada@example.com","active":true,"roles":["admin","user"]}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub id: i64,
    pub name: String,
    pub email: String,
    pub active: bool,
    pub roles: Vec<String>,
}

{"repo":"serde","owner":{"login":"dtolnay","id":100}}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub repo: String,
    pub owner: Owner,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Owner {
    pub login: String,
    pub id: i64,
}

{"users":[{"id":1,"nick":"x"},{"id":2}]}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub users: Vec<User>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct User {
    pub id: i64,
    pub nick: Option<String>,
}

{"login":"octocat","publicRepos":15,"followerCount":9001,"createdAt":"2011-01-25"}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub login: String,
    #[serde(rename = "publicRepos")]
    pub public_repos: i64,
    #[serde(rename = "followerCount")]
    pub follower_count: i64,
    #[serde(rename = "createdAt")]
    pub created_at: String,
}

Come convertire JSON in Rust

1. 1

   Incolla il tuo JSON

   Inserisci un oggetto JSON, un array o una risposta API nel campo di input. La conversione parte istantaneamente.

2. 2

   Regola l'output

   Rinomina lo struct radice e attiva le derivazioni serde, Debug e Clone, o la visibilità pub per adattarlo allo stile del tuo crate.

3. 3

   Copia o scarica

   Prendi il Rust generato con un clic e incollalo direttamente nel tuo progetto.

Common Use Cases

Client API tipizzati

Trasforma una risposta di esempio REST o GraphQL in struct serde per un client reqwest o simile senza scrivere a mano il boilerplate di deserializzazione.

Parsing di configurazioni e fixture

Genera struct per file di configurazione JSON, fixture di test o payload di webhook che devi deserializzare con serde_json.

Prototipazione rapida

Incolla un payload sconosciuto per vedere all'istante la sua forma come tipi Rust — un modo rapido per esplorare una nuova API prima di collegarla.

Come funziona la conversione

Inferenza strutturale

Ogni oggetto diventa uno struct con nome; le forme identiche vengono deduplicate così ottieni un solo struct, non copie. Gli array di oggetti vengono uniti chiave per chiave, e le chiavi assenti in alcuni elementi diventano Option<T>.

Tipizzazione numerica corretta

Gli interi diventano i64, passano a u64 oltre i64::MAX, e ripiegano su f64 oltre u64. I valori in virgola mobile vengono rilevati dal token (1.0, 2e3) così la deserializzazione serde non fallisce mai per un float in un campo intero.

Identificatori idiomatici e compilabili

Le chiavi diventano campi snake_case con #[serde(rename)] che rimanda alla chiave originale; le parole chiave di Rust, i nomi duplicati e le chiavi non identificatori vengono ripulite così l'output compila sempre.

100% lato client

Il parsing e la generazione girano nel tuo browser senza chiamate di rete, così i tuoi dati restano privati.

Consigli per struct Rust puliti

Dai un nome allo struct radice

Imposta un nome radice significativo (ad esempio User, ApiResponse) invece del Root predefinito per un codice leggibile.

Aggiungi serde_json solo quando serve

serde_json::Value compare per array vuoti o di tipi misti e campi solo null. Assegna a quei campi un tipo concreto da un campione più ricco se puoi, oppure aggiungi serde_json a Cargo.toml.

Rivedi Option rispetto a obbligatorio

I campi vengono contrassegnati come Option<T> solo quando un campione li omette. Incolla un payload rappresentativo così lo strumento deduce con precisione i campi obbligatori e opzionali.

Domande frequenti