JSON-Tags
Das Marshaling steuern
JSON-Tags ist eine kostenlose Go Academy-Lektion auf CoddyKit. Dies ist Lektion 2 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Go Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Go Academy-Kurs umfasst insgesamt 4 Lektionen.
JSON-Tags steuern das Marshaling
Das Paket encoding/json verwendet json-Tags, um beim Umwandeln von Structs in JSON und zurück die Schlüsselnamen und Regeln festzulegen.
Standardmäßige Feldnamen
Ohne Tags entsprechen JSON-Schlüssel exakt den Namen exportierter Felder, einschließlich der Groß- und Kleinschreibung.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string
Age int
}
func main() {
b, _ := json.Marshal(User{"Ann", 30})
fmt.Println(string(b))
}Schlüssel umbenennen
Ein json-Tag ändert den Schlüsselnamen in der Ausgabe. Hier wird aus Name der kleingeschriebene Name.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
Age int "json:\"age\""
}
func main() {
b, _ := json.Marshal(User{"Ann", 30})
fmt.Println(string(b))
}Die Option omitempty
Fügen Sie ,omitempty hinzu, um ein Feld in der Ausgabe zu überspringen, wenn es seinen Nullwert enthält (leere Zeichenkette, 0, nil usw.).
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
Email string "json:\"email,omitempty\""
}
func main() {
b, _ := json.Marshal(User{Name: "Ann"})
fmt.Println(string(b))
}Ein Feld ignorieren
Ein Tag mit - weist den Encoder an, das Feld vollständig zu überspringen – nützlich für Geheimnisse wie Passwörter.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
Password string "json:\"-\""
}
func main() {
b, _ := json.Marshal(User{"Ann", "secret"})
fmt.Println(string(b))
}Unmarshaling mit Tags
Tags funktionieren in beide Richtungen. Beim Decodieren von JSON gibt das Tag an, welcher JSON-Schlüssel welches Feld füllt.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
}
func main() {
var u User
json.Unmarshal([]byte("{\"name\":\"Bob\"}"), &u)
fmt.Println(u.Name)
}Groß- und Kleinschreibung wird ignoriert
Beim Unmarshaling ordnet Go JSON-Schlüssel ersatzweise ohne Berücksichtigung der Groß- und Kleinschreibung zu. Trotzdem ist es sicherer und eindeutiger, Tags ausdrücklich zu definieren.
Die Option string
Die Option ,string kodiert ein numerisches oder boolesches Feld als JSON-Zeichenkette. Das ist nützlich für Systeme, die Zahlen in Anführungszeichen erwarten.
package main
import (
"encoding/json"
"fmt"
)
type Item struct {
ID int "json:\"id,string\""
}
func main() {
b, _ := json.Marshal(Item{ID: 42})
fmt.Println(string(b))
}Optionen kombinieren
Sie können einen Namen mit Optionen kombinieren: json:"email,omitempty". Der Name steht zuerst, danach folgen durch Kommas getrennte Optionen.
Nicht exportierte Felder werden übersprungen
Nur exportierte (großgeschriebene) Felder werden serialisiert. Ein kleingeschriebenes Feld ist für encoding/json unabhängig von seinem Tag unsichtbar.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
age int
}
func main() {
b, _ := json.Marshal(User{Name: "Ann", age: 30})
fmt.Println(string(b))
}Lesbare Ausgabe
json.MarshalIndent formatiert JSON mit Einrückungen. Das ist praktisch für gut lesbare Protokolle, wobei Tags weiterhin berücksichtigt werden.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
}
func main() {
b, _ := json.MarshalIndent(User{"Ann"}, "", " ")
fmt.Println(string(b))
}Kurzer Check
Was bewirkt die Option ,omitempty in einem JSON-Tag?
Zusammenfassung
JSON-Tags steuern das Marshaling:
- Benennen Sie Schlüssel mit
json:"name"um ,omitemptyüberspringt Nullwerte-ignoriert ein Feld;,stringsetzt Zahlen in Anführungszeichen- Nur exportierte Felder werden codiert
Häufig gestellte Fragen
Ist die Lektion „JSON-Tags“ kostenlos?
Ja — der vollständige Text von „JSON-Tags“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Go Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Go Academy-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „JSON-Tags“?
Das Marshaling steuern Du übst Go Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um Go Academy zu starten?
Keine Vorkenntnisse erforderlich. Go Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 2 von 4.
Wie lange dauert die Lektion „JSON-Tags“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser Go Academy-Lektion Code schreiben und ausführen?
Ja. Jede Go Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.