JSON in Go Struct
Füge ein JSON-Objekt oder eine API-Antwort ein und erhalte sofort einsetzbare Go-Structs mit passenden Feldnamen, json-Tags und erkannten Typen wie int64, float64, bool und time.Time. Alles läuft in deinem Browser.
Zuletzt aktualisiert:
Dein JSON wird lokal in diesem Tab geparst und nie hochgeladen. Tipp: Strg + Eingabe generiert.
Anleitung: JSON in Go Struct
- Füge dein JSON in das linke Feld ein oder öffne eine .json-Datei. Ein Beispiel ist geladen, damit du die Ausgabe sofort siehst.
- Benenne das Root-Struct und auf Wunsch das Package (leer lassen, um die package-Zeile wegzulassen).
- Wähle die Optionen: omitempty-Modus, int oder int64, Inline-Structs, Pointer für null-Werte, time.Time und any.
- Klicke auf Go-Structs generieren. Mit aktivierter Live-Aktualisierung wird der Code beim Tippen erneuert.
- Kopiere oder lade die .go-Datei herunter und dekodiere mit json.Unmarshal(data, &v).
Beispiel: JSON in Go-Structs
Diese API-Antwort enthält ein verschachteltes Objekt, ein Array von Objekten und einen Wert, der null sein kann:
{ "user_id": 42, "name": "Ada", "avatar_url": null,
"posts": [ { "id": 1, "title": "Hello", "score": 4.5 },
{ "id": 2, "title": "Draft", "score": 3, "cover": "a.png" } ] }Mit den Standardoptionen erzeugt der Generator:
type Root struct {
UserID int `json:"user_id"`
Name string `json:"name"`
AvatarURL any `json:"avatar_url,omitempty"`
Posts []Post `json:"posts"`
}
type Post struct {
ID int `json:"id"`
Title string `json:"title"`
Score float64 `json:"score"`
Cover string `json:"cover,omitempty"`
}score ist float64, weil ein Eintrag 4.5 enthält, und cover bekommt omitempty, weil nur ein Eintrag es hat. Da avatar_url immer nur null ist, lässt sich sein eigentlicher Typ nicht bestimmen, also ist es any: Ersetze es durch *string, sobald du es weißt.
So werden JSON-Werte auf Go-Typen abgebildet
| JSON-Wert | Go-Typ |
|---|---|
"text" | string |
"2024-05-01T09:30:00Z" | time.Time (RFC 3339, wenn die Option aktiviert ist) |
42 | int oder int64 über 2,147,483,647 |
3.14, 1e6 | float64 |
true / false | bool |
"x" oder null | *string (Pointer, sodass nil für null steht) |
{ … } | Ein benanntes Struct (oder ein Inline-struct { … }) |
{} | map[string]any |
[1, 2] / [] | []int / []any |
[1, "two"] | []any (Go kennt keine Union-Typen) |
Die Structs verwenden
var root Root
if err := json.Unmarshal(data, &root); err != nil {
log.Fatal(err)
}
fmt.Println(root.Posts[0].Title)- Unbekannte Schlüssel werden ignoriert. json.Unmarshal überspringt Schlüssel ohne passendes Feld. Nutze einen
json.DecodermitDisallowUnknownFields(), wenn du striktes Dekodieren willst. - time.Time erwartet RFC 3339. Zeitstempel wie
2024-05-01T09:30:00Zwerden direkt dekodiert; andere Formate brauchen einen eigenen Typ oder ein string-Feld. - Große IDs. JSON-Zahlen über 253 verlieren in JavaScript an Genauigkeit, nicht aber in Gos int64, behalte also int64 für IDs im Snowflake-Stil.
Häufige Fragen
Wie werden Go-Feldnamen aus JSON-Schlüsseln erzeugt?
Jeder Schlüssel wird an Unterstrichen, Bindestrichen, Leerzeichen und camelCase-Grenzen in Wörter zerlegt, und jedes Wort wird großgeschrieben, damit das Feld exportiert wird. Gängige Initialismen werden wie im Go-Stil vorgeschrieben komplett großgeschrieben, sodass user_id zu UserID und avatar_url zu AvatarURL wird. Der ursprüngliche Schlüssel bleibt im json-Tag erhalten, damit das Unmarshalling weiterhin passt.
Warum sind die Felder exportiert (großgeschrieben)?
encoding/json kann nur exportierte Struct-Felder lesen und schreiben. Ein kleingeschriebenes Feld würde von json.Unmarshal stillschweigend ignoriert, daher beginnt jedes generierte Feld mit einem Großbuchstaben, und der json-Tag ordnet es wieder dem ursprünglichen Schlüssel zu.
Wann wird omitempty hinzugefügt?
Standardmäßig wird omitempty bei Feldern hinzugefügt, die in manchen Array-Einträgen fehlen oder null enthalten, denn genau diese Felder können fehlen. Du kannst es stattdessen bei allen oder bei keinen Feldern hinzufügen lassen. Beachte, dass omitempty nur das Marshalling (Kodieren) beeinflusst; das Dekodieren von JSON ändert es nicht.
Wie werden Zahlen typisiert?
Ganze Zahlen werden zu int oder zu int64, wenn ein Wert außerhalb des 32-Bit-Bereichs liegt (du kannst int64 überall erzwingen). Zahlen mit Dezimalpunkt oder Exponent werden zu float64. Mischt ein Feld ganze Zahlen und Dezimalzahlen, wird float64 verwendet.
Was passiert mit null-Werten und gemischten Typen?
Ein Feld, das an manchen Stellen einen Wert und an anderen null enthält, wird zu einem Pointer wie *string, sodass nil für null stehen kann. Ein Feld, das immer null ist oder Typen wie string und number mischt, wird zu any (oder interface{}), weil Go keine Union-Typen kennt.
Inline- oder separate Structs: Was sollte ich verwenden?
Separate benannte Structs lassen sich leichter wiederverwenden, testen und dokumentieren, deshalb sind sie der Standard. Anonyme Inline-Structs halten alles in einem Typ und sind praktisch für einmalige API-Antworten, lassen sich aber an anderer Stelle im Code nicht so leicht erzeugen.
Wird mein JSON hochgeladen?
Nein. Parsen und Codegenerierung sind reines JavaScript auf dieser Seite, API-Antworten mit persönlichen oder geheimen Daten verlassen also nie dein Gerät.
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.