Секретные ярлычки Go: что такое struct tags и зачем они нужны

Вступление: магические кавычки в коде Go

Если вы когда-нибудь писали на Go структуры для работы с JSON, то наверняка видели вот такие странные конструкции:

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

Эти загадочные обратные кавычки (`json:"name"`) называются struct tags (теги структур). Для новичка они выглядят как магия или лишний шум. Но на самом деле это одна из самых мощных и элегантных фич Go, которая позволяет мета-программировать без сложных макросов.

В этой статье мы разберём, что такое struct tags в Go, зачем они нужны, какие бывают, и как их использовать в реальных проектах. Вы перестанете бояться этих «магических строк» и начнёте использовать их осознанно.

Что такое struct tags? Простое объяснение

Struct tags — это строковые литералы, которые записываются после типа поля в структуре. Они заключены в обратные кавычки (`) и представляют собой пары ключ:"значение".

С точки зрения языка, теги структур в Go — это просто текст. Go компилятор их не анализирует и не проверяет. Их смысл появляется только тогда, когда вы (или библиотека) читаете их через пакет reflect.

Проще говоря: теги — это метаданные, которые вы прикрепляете к полям структуры. Другие части вашей программы могут читать эти метаданные и менять своё поведение.

Зачем нужны struct tags? 3 главных сценария

1. Сериализация/десериализация (JSON, XML, YAML)

Это самый частый и понятный вариант использования. Представьте, что у вас есть Go-структура, и вы хотите превратить её в JSON (или наоборот).

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: "Иван", LastName: "Петров", Password: "secret"}
    jsonData, _ := json.Marshal(user)
    fmt.Println(string(jsonData))
    // Вывод: {"id":1,"first_name":"Иван","last_name":"Петров"}
    // Пароль не попал в JSON, потому что тег json:"-"
}

Без тегов поля назывались бы ID, FirstName и т.д., что не соответствует стилю JSON (camelCase vs snake_case). Golang struct tags для JSON позволяют контролировать:

• Имя поля в JSON
• Пропуск пустых полей (omitempty)
• Исключение поля из вывода (-)
• Вложенные опции

2. Валидация данных

Популярные библиотеки вроде go-playground/validator используют теги структур Go для валидации. Вы просто пишете правила прямо в структуре:

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
}

Это невероятно удобно: правила валидации находятся рядом с данными, а не размазаны по коду. Struct tags для валидации делают код самодокументируемым.

3. Работа с базами данных (ORM)

ORM-библиотеки (GORM, Ent, SQLBoiler) активно используют struct tags для ORM. Например, в GORM:

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

Теги gorm задают индексы, ограничения, внешние ключи и другие настройки таблицы. Это избавляет от необходимости писать отдельные миграции.

Как работают struct tags изнутри (немного магии reflect)

Чтобы понять, как библиотеки читают теги, нужно заглянуть в пакет reflect. Это не обязательно для повседневного использования, но даёт глубокое понимание.

type Config struct {
    Host string `env:"HOST" default:"localhost"`
    Port int    `env:"PORT" default:"8080"`
}

func readTags(s interface{}) {
    t := reflect.TypeOf(s)
    for i := 0; i < t.NumField(); i++ {
        field := t.Field(i)
        envTag := field.Tag.Get("env")
        defaultTag := field.Tag.Get("default")
        fmt.Printf("Поле %s: env=%s, default=%s\n", field.Name, envTag, defaultTag)
    }
}

func main() {
    cfg := Config{}
    readTags(cfg)
    // Вывод:
    // Поле Host: env=HOST, default=localhost
    // Поле Port: env=PORT, default=8080
}

Метод field.Tag.Get("key") извлекает значение тега по ключу. Если вы пишете свою библиотеку, вы можете придумать любой ключ и любые значения — синтаксис struct tags в Go это позволяет.

Популярные библиотеки и их теги

Вот список распространённых ключей тегов, которые вы встретите в реальных проектах:

Продвинутые техники: как создать свой тег

Вы можете создать свой собственный тег для любой задачи. Например, автоматическое заполнение структуры из переменных окружения:

type AppConfig struct {
    DBHost string `env:"DB_HOST" default:"localhost"`
    DBPort int    `env:"DB_PORT" default:"5432"`
    Debug  bool   `env:"DEBUG" default:"false"`
}

func LoadConfigFromEnv(cfg interface{}) {
    t := reflect.TypeOf(cfg).Elem()
    v := reflect.ValueOf(cfg).Elem()

    for i := 0; i &