Для чего нужны теги структур (struct tags) в Go и как их использовать?

Что такое теги структур и зачем они нужны?

Теги структур (struct tags) в Go — это строковые метаданные, которые прикрепляются к полям структуры. Они записываются в обратных кавычках (`...`) после типа поля. Сами по себе теги не влияют на выполнение кода — это просто строки. Но их можно прочитать во время выполнения программы через пакет reflect (рефлексию), и на основе этой информации выполнять различные действия.

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

Основные сценарии использования

• Сериализация/десериализация (JSON, XML, YAML, TOML, BSON) — самый популярный случай.
• Валидация данных — проверка обязательности полей, диапазонов значений, форматов.
• ORM и базы данных — маппинг полей структуры на столбцы таблиц.
• Формы и HTTP-запросы — привязка параметров запроса к полям структуры.
• Собственные библиотеки — вы можете написать свой парсер, который читает теги и делает что-то полезное.

Как это работает на примере JSON

Рассмотрим классический пример с JSON:

package main

import (
    "encoding/json"
    "fmt"
)

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

func main() {
    u := User{
        Name:     "Алексей",
        Age:      30,
        Password: "secret123",
    }
    
    data, _ := json.Marshal(u)
    fmt.Println(string(data)) 
    // Вывод: {"name":"Алексей","age":30}
    // Поле Password не попало в JSON из-за тега `json:"-"`
}

Разберем теги:

• json:"name" — при сериализации поле Name будет называться "name" (в нижнем регистре).
• json:"age,omitempty" — если поле Age равно нулевому значению (0), оно будет пропущено.
• json:"-" — поле полностью игнорируется при работе с JSON.

Как прочитать теги самостоятельно (с помощью рефлексии)

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

package main

import (
    "fmt"
    "reflect"
    "strings"
)

type User struct {
    Name  string `validate:"required"`
    Email string `validate:"required,email"`
    Age   int    `validate:"min=18,max=120"`
}

func Validate(s interface{}) error {
    t := reflect.TypeOf(s)
    v := reflect.ValueOf(s)
    
    for i := 0; i < t.NumField(); i++ {
        field := t.Field(i)
        tag := field.Tag.Get("validate")
        if tag == "" {
            continue
        }
        
        value := v.Field(i)
        rules := strings.Split(tag, ",")
        
        for _, rule := range rules {
            switch {
            case rule == "required":
                if value.String() == "" {
                    return fmt.Errorf("поле %s обязательно", field.Name)
                }
            case strings.HasPrefix(rule, "min="):
                // логика проверки минимального значения
            case strings.HasPrefix(rule, "max="):
                // логика проверки максимального значения
            }
        }
    }
    return nil
}

func main() {
    u := User{Name: "", Email: "test@test.com", Age: 25}
    err := Validate(u)
    fmt.Println(err) // поле Name обязательно
}

Подводные камни и советы

• Пробелы в тегах имеют значение. json:" name" (с пробелом) — это не то же самое, что json:"name". Пробел станет частью имени.
• Не злоупотребляйте рефлексией. Чтение тегов через reflect — медленная операция. Для высоконагруженных мест лучше кешировать результат или использовать кодогенерацию.
• Порядок тегов не важен, но обычно их пишут в алфавитном порядке для читаемости.
• Можно комбинировать теги: `json:"name" bson:"name" validate:"required"` — каждая библиотека возьмет свое.
• Теги — это строки. Компилятор не проверяет их корректность. Ошибка в теге (опечатка) проявится только во время выполнения.

Заключение

Теги структур — это мощный механизм метапрограммирования в Go. Они позволяют писать компактный и выразительный код, не раздувая его дополнительными функциями для преобразования данных. Главное — помнить, что теги не являются частью типа и не влияют на поведение структуры, пока вы явно не прочитаете их через рефлексию или готовую библиотеку.

type User struct {
    Name     string
    Age      int
    Password string
}

func (u User) MarshalJSON() ([]byte, error) {
    return json.Marshal(map[string]interface{}{
        "name": u.Name,
        "age":  u.Age,
        // Password не включаем
    })
}