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

Проблема: отсутствие значений по умолчанию в Go

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

Решение 1: Функция-конструктор (рекомендуемый способ)

Самый популярный и правильный в Go способ — создать функцию, которая возвращает экземпляр структуры с уже заполненными полями. Обычно её называют New или NewИмяСтруктуры:

type ServerConfig struct {
    Port    int
    Timeout int
    Name    string
}

// NewServerConfig — конструктор со значениями по умолчанию
func NewServerConfig() ServerConfig {
    return ServerConfig{
        Port:    8080,
        Timeout: 30,
        Name:    "MyServer",
    }
}

func main() {
    config := NewServerConfig()
    fmt.Println(config.Port)    // 8080
    fmt.Println(config.Timeout) // 30
    fmt.Println(config.Name)    // "MyServer"
}

Преимущества этого подхода:

• Явность — сразу видно, какие значения устанавливаются.
• Гибкость — можно добавить валидацию или логику в конструкторе.
• Идиоматичность — это стандартный паттерн в Go.

Решение 2: Функциональные опции (Functional Options Pattern)

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

type ServerConfig struct {
    Port    int
    Timeout int
    Name    string
}

// ServerOption — тип для опции
type ServerOption func(*ServerConfig)

// WithPort — опция для установки порта
func WithPort(port int) ServerOption {
    return func(c *ServerConfig) {
        c.Port = port
    }
}

// WithTimeout — опция для установки таймаута
func WithTimeout(timeout int) ServerOption {
    return func(c *ServerConfig) {
        c.Timeout = timeout
    }
}

// WithName — опция для установки имени
func WithName(name string) ServerOption {
    return func(c *ServerConfig) {
        c.Name = name
    }
}

// NewServerConfig — конструктор с опциями
func NewServerConfig(opts ...ServerOption) ServerConfig {
    // Значения по умолчанию
    config := ServerConfig{
        Port:    8080,
        Timeout: 30,
        Name:    "MyServer",
    }
    // Применяем опции
    for _, opt := range opts {
        opt(&config)
    }
    return config
}

func main() {
    // Использование: только кастомный порт, остальное — по умолчанию
    config := NewServerConfig(WithPort(9090))
    fmt.Println(config.Port)    // 9090
    fmt.Println(config.Timeout) // 30 (по умолчанию)
    fmt.Println(config.Name)    // "MyServer" (по умолчанию)
}

Решение 3: Метод Init для явной инициализации

Иногда используют метод, который заполняет нулевые поля значениями по умолчанию. Это удобно, если структура создаётся не только через конструктор:

type ServerConfig struct {
    Port    int
    Timeout int
    Name    string
}

func (c *ServerConfig) Init() {
    if c.Port == 0 {
        c.Port = 8080
    }
    if c.Timeout == 0 {
        c.Timeout = 30
    }
    if c.Name == "" {
        c.Name = "MyServer"
    }
}

func main() {
    config := ServerConfig{Port: 3000}
    config.Init()
    fmt.Println(config.Port)    // 3000 (не перезаписалось)
    fmt.Println(config.Timeout) // 30 (установлено)
    fmt.Println(config.Name)    // "MyServer" (установлено)
}

Важно: Этот метод опасен, если 0 или пустая строка — допустимые значения для поля. Например, порт 0 может означать "выбрать случайный порт". Поэтому используйте его только когда уверены, что нулевое значение невалидно.

Совет: избегайте глобальных констант по умолчанию

Некоторые новички делают так:

var defaultPort = 8080

type ServerConfig struct {
    Port int `default:"8080"` // ❌ теги не поддерживают значения по умолчанию
}

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

Итог

Лучший способ — функция-конструктор. Если нужна гибкость — функциональные опции. Метод Init используйте только для простых случаев. Главное — помните: в Go всё должно быть явным.

// DefaultConfig — базовая структура с умолчаниями
type DefaultConfig struct {
    Port    int
    Timeout int
}

func NewDefaultConfig() DefaultConfig {
    return DefaultConfig{
        Port:    8080,
        Timeout: 30,
    }
}

// ServerConfig — встраиваем DefaultConfig
type ServerConfig struct {
    DefaultConfig
    Name string
}

func main() {
    config := ServerConfig{
        DefaultConfig: NewDefaultConfig(),
        Name:          "MyServer",
    }
    fmt.Println(config.Port)    // 8080
    fmt.Println(config.Timeout) // 30
    fmt.Println(config.Name)    // "MyServer"
}