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

Что такое теги структур в Go?

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

Как работают теги?

Каждый тег — это строка, которая интерпретируется функциями, работающими с рефлексией. Например, пакет encoding/json использует тег json для определения имени поля при сериализации/десериализации. Если тег не указан, используется имя поля как есть.

Пример базового использования с JSON:

package main

import (
    "encoding/json"
    "fmt"
)

type User struct {
    ID    int    `json:"id"`
    Name  string `json:"name"`
    Email string `json:"email,omitempty"`
}

func main() {
    user := User{ID: 1, Name: "Alice"}
    jsonBytes, _ := json.Marshal(user)
    fmt.Println(string(jsonBytes)) // {"id":1,"name":"Alice"}
}

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

• Сериализация/десериализация: JSON, XML, YAML, BSON, TOML и другие форматы.
• Валидация: пакеты вроде go-playground/validator используют теги для определения правил проверки.
• ORM и базы данных: GORM использует теги для маппинга полей на столбцы таблиц.
• Формы и HTTP: библиотеки для работы с формами читают теги form.

Пример валидации:

type SignUpRequest struct {
    Email    string `validate:"required,email"`
    Password string `validate:"required,min=8"`
    Age      int    `validate:"gte=0,lte=130"`
}

Как написать свой парсер тегов?

Для чтения тегов используется пакет reflect. Вот пример, который выводит все теги структуры:

package main

import (
    "fmt"
    "reflect"
)

type Product struct {
    Name  string `json:"name" db:"product_name"`
    Price float64 `json:"price" db:"price"`
}

func main() {
    t := reflect.TypeOf(Product{})
    for i := 0; i < t.NumField(); i++ {
        field := t.Field(i)
        fmt.Printf("Поле: %s\n", field.Name)
        fmt.Printf("  json: %s\n", field.Tag.Get("json"))
        fmt.Printf("  db: %s\n", field.Tag.Get("db"))
    }
}

Вывод:

Поле: Name
  json: name
  db: product_name
Поле: Price
  json: price
  db: price

Почему не использовать имена полей напрямую?

Теги решают несколько проблем:

• Разные имена в коде и в данных: например, в Go принято использовать CamelCase, а в JSON — snake_case.
• Пропуск полей: опция omitempty позволяет не включать пустые поля в вывод.
• Игнорирование полей: тег json:"-" полностью исключает поле из сериализации.
• Множественные форматы: одно поле может иметь теги для JSON, XML, базы данных и валидации одновременно.

Пример с игнорированием поля:

type User struct {
    ID       int    `json:"id"`
    Password string `json:"-"`
    Token    string `json:"token,omitempty"`
}

В этом примере пароль никогда не попадёт в JSON, а токен будет включён только если не пустой.

Заключение

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

type User struct {
    ID        uint      `gorm:"primaryKey;autoIncrement"`
    Name      string    `gorm:"type:varchar(100);not null"`
    CreatedAt time.Time `gorm:"autoCreateTime"`
    DeletedAt gorm.DeletedAt `gorm:"index"`
}

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

// Функция чтения из переменных окружения
func LoadConfigFromEnv(v interface{}) {
    t := reflect.TypeOf(v).Elem()
    for i := 0; i < t.NumField(); i++ {
        field := t.Field(i)
        envName := field.Tag.Get("env")
        if envName != "" {
            if val := os.Getenv(envName); val != "" {
                // устанавливаем значение
            }
        }
    }
}