Startseite › Entwickler-Tools › JSON in Rust-Struct

JSON in Rust-Struct

Füge ein JSON-Objekt oder eine API-Antwort ein und erhalte idiomatische Rust-Structs, die mit serde kompilieren: Felder in snake_case, #[serde(rename_all)] oder Umbenennungen pro Feld, Option<T> für nullable Werte, Vec<T> für Arrays und ein Struct für jedes verschachtelte Objekt. Alles läuft in deinem Browser.

Zuletzt aktualisiert:

Dein JSON wird lokal in diesem Tab verarbeitet und nie hochgeladen. Tipp: Strg + Eingabe erzeugt den Code.

Anzeige
Anzeige

Anleitung: JSON in Rust-Struct

  1. Füge dein JSON in das linke Feld ein oder öffne eine .json-Datei. Ein Beispiel ist geladen, damit du die Ausgabe sofort siehst.
  2. Benenne das Root-Struct, zum Beispiel User oder ApiResponse.
  3. Wähle die Optionen: welche serde-Derives hinzugefügt werden, den Ganzzahltyp, rename_all oder Umbenennungen pro Feld, Option für fehlende Felder und zusätzliche Derives.
  4. Klicke auf Rust-Structs erzeugen. Mit aktivierter Live-Aktualisierung wird der Code während der Eingabe aktualisiert.
  5. Kopiere oder lade die .rs-Datei herunter, füge serde (mit dem Feature derive) und serde_json zur Cargo.toml hinzu und rufe serde_json::from_str auf.

Beispiel: JSON in Rust-Structs mit serde

Diese Antwort hat camelCase-Schlüssel, einen nullable Wert, ein Rust-Schlüsselwort als Schlüssel und ein Array von Objekten, in dem ein Schlüssel optional ist:

{ "userId": 42, "displayName": "Ada", "avatarUrl": null,
  "posts": [ { "id": 1, "type": "article", "score": 4.5 },
             { "id": 2, "type": "note", "score": 3, "coverImage": "a.png" } ] }

Mit den Standardoptionen erzeugt der Generator:

use serde::{Deserialize, Serialize};
use serde_json::Value;

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Root {
    pub user_id: i64,
    pub display_name: String,
    pub avatar_url: Value,
    pub posts: Vec<Post>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Post {
    pub id: i64,
    pub r#type: String,
    pub score: f64,
    pub cover_image: Option<String>,
}

score ist f64, weil ein Element 4.5 hat, cover_image ist eine Option, weil nur ein Beitrag es hat, und avatar_url ist Value, weil es immer nur null ist und sein Typ daher unbekannt ist. Ändere es in Option<String>, sobald du den Typ kennst.

Wie JSON-Werte auf Rust-Typen abgebildet werden

JSON-WertRust-Typ
"Text"String
42i64 (oder per Option i32 / u64)
3.14, 1e6f64
true / falsebool
"x" oder nullOption<String>
Schlüssel fehlt in manchen ElementenOption<T> (oder #[serde(default)])
{ … }Ein benanntes struct
{}HashMap<String, Value>
[1, 2] / []Vec<i64> / Vec<Value>
Nur null oder gemischte Typenserde_json::Value

Die Structs verwenden

# Cargo.toml
[dependencies]
serde = { version = "1", features = ["derive"] }
serde_json = "1"

// main.rs
let root: Root = serde_json::from_str(&json)?;
println!("{}", root.posts[0].r#type);
let back = serde_json::to_string_pretty(&root)?;
  • Unbekannte Schlüssel werden standardmäßig ignoriert. Aktiviere deny_unknown_fields, damit die Deserialisierung fehlschlägt, wenn das JSON Schlüssel enthält, die das Struct nicht kennt.
  • skip_serializing_if lässt None-Felder in der Ausgabe weg, statt null zu schreiben, wodurch das serialisierte JSON näher am Original bleibt.
  • Datumsangaben bleiben String. Für typisierte Zeitstempel füge das Crate chrono mit seinem serde-Feature hinzu und ändere das Feld in chrono::DateTime<chrono::Utc>.

Häufige Fragen

Welche Crates brauchen die erzeugten Structs?

Füge serde mit dem Feature derive und serde_json zur Cargo.toml hinzu: serde = { version = "1", features = ["derive"] } und serde_json = "1". Die Structs verwenden #[derive(Serialize, Deserialize)] aus serde und, wenn ein Feld gemischte Typen enthalten kann, serde_json::Value.

Wie werden JSON-Schlüssel zu Rust-Feldnamen?

Jeder Schlüssel wird an camelCase-Grenzen, Bindestrichen, Leerzeichen und Unterstrichen in Wörter zerlegt und dann in snake_case zusammengesetzt, sodass aus userName user_name wird. Folgen die meisten Schlüssel eines Structs einer Konvention, fügt der Generator #[serde(rename_all = "camelCase")] hinzu (oder PascalCase, kebab-case bzw. SCREAMING_SNAKE_CASE) und ergänzt #[serde(rename = "...")] nur bei Schlüsseln, die nicht passen, damit serde weiterhin das ursprüngliche JSON liest.

Wann wird ein Feld zu Option<T>?

Ein Feld wird zu Option<T>, wenn es an mindestens einer Stelle null ist oder (bei aktivierter Option) wenn der Schlüssel in manchen Elementen eines Arrays fehlt. serde deserialisiert ein fehlendes Option-Feld automatisch als None. Schaltest du die Option aus, erhalten fehlende Felder stattdessen #[serde(default)].

Was passiert mit Rust-Schlüsselwörtern wie type oder match?

Schlüsselwörter werden als Raw Identifier geschrieben, zum Beispiel pub r#type: String. serde entfernt das Präfix r#, sodass das Feld weiterhin dem JSON-Schlüssel "type" zugeordnet ist. self, Self, super und crate können keine Raw Identifier sein, daher erhalten sie einen Unterstrich am Ende plus ein rename-Attribut.

Wie werden Zahlen typisiert?

Ganze Zahlen werden standardmäßig zu i64, Zahlen mit Dezimalpunkt oder Exponent zu f64. Du kannst i32 wählen, wenn jeder Wert in 32 Bit passt, oder u64, wenn kein Wert negativ ist. Mischt ein Feld ganze und Dezimalzahlen, wird es zu f64. Ganzzahlen, die für 64 Bit zu groß sind, werden als f64 behandelt.

Was ist mit Feldern, die nur null sind, leeren Arrays und gemischten Typen?

Ist ein Wert immer null, lässt sich sein echter Typ nicht bestimmen, daher wird er zu serde_json::Value. Leere Arrays werden zu Vec<Value>, und Felder mit gemischten Typen (etwa ein String in einem Element und eine Zahl in einem anderen) verwenden ebenfalls Value, weil Rust keine Ad-hoc-Union-Typen hat. Ersetze sie durch einen konkreten Typ oder ein Enum, sobald du die Daten kennst.

Wird mein JSON irgendwo hochgeladen?

Nein. Parsen und Codeerzeugung sind reines JavaScript auf dieser Seite, sodass API-Antworten mit persönlichen oder geheimen Daten nie dein Gerät verlassen.

Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

Ähnliche Tools

Alle Daten- & Dateiformat-Konverter ansehen →