Geheime Go-Tags: Was sind Struct Tags und wozu braucht man sie?

Online Python-Trainer für Anfänger

Lernen Sie Python einfach ohne theoretische Überlastung. Lösen Sie praktische Aufgaben mit automatischer Überprüfung und schreiben Sie Code direkt im Browser.

Kurs starten

Einleitung: Magische Anführungszeichen in Go-Code

Wenn Sie jemals Go-Strukturen für die Arbeit mit JSON geschrieben haben, haben Sie sicherlich solche seltsamen Konstrukte gesehen:

type User struct {    Name string `json:"name"`    Age  int    `json:"age,omitempty"`}

Diese geheimnisvollen Backticks (`json:"name"`) werden Struct Tags genannt. Für Anfänger sehen sie wie Magie oder unnötiges Rauschen aus. Aber tatsächlich ist dies eine der mächtigsten und elegantesten Funktionen von Go, die Metaprogrammierung ohne komplexe Makros ermöglicht.

In diesem Artikel werden wir erklären, was Struct Tags in Go sind, wozu sie dienen, welche Arten es gibt und wie man sie in realen Projekten einsetzt. Sie werden keine Angst mehr vor diesen „magischen Zeichenketten“ haben und beginnen, sie bewusst zu nutzen.

Was sind Struct Tags? Einfache Erklärung

Struct Tags sind Zeichenkettenliterale, die nach dem Feldtyp in einer Struktur geschrieben werden. Sie sind in Backticks (`) eingeschlossen und bestehen aus Paaren von schlüssel:"wert".

Aus Sicht der Sprache sind Struktur-Tags in Go einfach Text. Der Go-Compiler analysiert oder überprüft sie nicht. Ihre Bedeutung entsteht erst, wenn Sie (oder eine Bibliothek) sie über das Paket reflect auslesen.

Einfach ausgedrückt: Tags sind Metadaten, die Sie an die Felder einer Struktur anhängen. Andere Teile Ihres Programms können diese Metadaten lesen und ihr Verhalten ändern.

Wozu braucht man Struct Tags? 3 Hauptszenarien

1. Serialisierung/Deserialisierung (JSON, XML, YAML)

Dies ist der häufigste und verständlichste Anwendungsfall. Stellen Sie sich vor, Sie haben eine Go-Struktur und möchten sie in JSON umwandeln (oder umgekehrt).

type User struct {    ID        int    `json:"id"`    FirstName string `json:"first_name"`    LastName  string `json:"last_name"`    Password  string `json:"-"`}

func main() {    user := User{ID: 1, FirstName: "Ivan", LastName: "Petrov", Password: "secret"}    jsonData, _ := json.Marshal(user)    fmt.Println(string(jsonData))    // Ausgabe: {"id":1,"first_name":"Ivan","last_name":"Petrov"}    // Das Passwort erscheint nicht im JSON, wegen des Tags json:"-"}

Ohne Tags würden die Felder ID, FirstName usw. heißen, was nicht dem JSON-Stil entspricht (camelCase vs. snake_case). Golang Struct Tags für JSON ermöglichen die Kontrolle über:

Den Feldnamen im JSON
Das Auslassen leerer Felder (omitempty)
Das Ausschließen eines Feldes aus der Ausgabe (-)
Verschachtelte Optionen

2. Datenvalidierung

Beliebte Bibliotheken wie go-playground/validator verwenden Go-Struktur-Tags zur Validierung. Sie schreiben die Regeln einfach direkt in die Struktur:

type SignUpRequest struct {    Email    string `validate:"required,email"`    Password string `validate:"required,min=8,max=32"`    Age      int    `validate:"gte=18,lte=120"`}

func validateUser(user SignUpRequest) error {    validate := validator.New()    err := validate.Struct(user)    return err}

Das ist unglaublich praktisch: Die Validierungsregeln befinden sich neben den Daten und sind nicht über den Code verteilt. Struct Tags für die Validierung machen den Code selbstdokumentierend.

3. Arbeit mit Datenbanken (ORM)

ORM-Bibliotheken (GORM, Ent, SQLBoiler) nutzen aktiv Struct Tags für ORM. Zum Beispiel in GORM:

type Product struct {    gorm.Model    Code  string `gorm:"uniqueIndex;not null"`    Price uint   `gorm:"default:0"`    UserID uint  `gorm:"foreignKey:UserID"`}

Die gorm-Tags definieren Indizes, Einschränkungen, Fremdschlüssel und andere Tabelleneinstellungen. Dies erspart das Schreiben separater Migrationen.