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

Проблема и её природа

Действительно, в Go нет встроенного механизма для указания значений по умолчанию в объявлении структуры. Это осознанное решение разработчиков языка: Go придерживается принципа явности и простоты. Нулевые значения (zero values) для всех типов — это часть спецификации языка: int → 0, string → "", bool → false, указатели и срезы → nil. Такой подход исключает неопределённое состояние и делает код предсказуемым.

Идиоматический подход: фабричная функция (Constructor)

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

package main

import "fmt"

type Config struct {
    Port    int
    Timeout int
    Debug   bool
}

// NewConfig создаёт Config со значениями по умолчанию.
// Пользователь может переопределить их через аргументы или после создания.
func NewConfig(port int, timeout int) Config {
    cfg := Config{
        Port:    8080,  // значение по умолчанию
        Timeout: 30,    // значение по умолчанию
        Debug:   false, // значение по умолчанию
    }

    // Если передан ненулевой аргумент, переопределяем
    if port != 0 {
        cfg.Port = port
    }
    if timeout != 0 {
        cfg.Timeout = timeout
    }

    return cfg
}

func main() {
    // Используем все значения по умолчанию
    cfg1 := NewConfig(0, 0)
    fmt.Printf("Default: %+v\n", cfg1) // {Port:8080 Timeout:30 Debug:false}

    // Переопределяем только порт
    cfg2 := NewConfig(9090, 0)
    fmt.Printf("Custom port: %+v\n", cfg2) // {Port:9090 Timeout:30 Debug:false}

    // Переопределяем всё
    cfg3 := NewConfig(3000, 60)
    fmt.Printf("Full custom: %+v\n", cfg3) // {Port:3000 Timeout:60 Debug:false}
}

Альтернатива: паттерн "Builder" или опциональные параметры

Если у структуры много полей и часть из них необязательна, удобно использовать функциональные опции (functional options). Это немного сложнее, но даёт гибкость:

type Config struct {
    Port    int
    Timeout int
    Debug   bool
}

type ConfigOption func(*Config)

func WithPort(p int) ConfigOption {
    return func(c *Config) {
        c.Port = p
    }
}

func WithTimeout(t int) ConfigOption {
    return func(c *Config) {
        c.Timeout = t
    }
}

func WithDebug(d bool) ConfigOption {
    return func(c *Config) {
        c.Debug = d
    }
}

func NewConfig(opts ...ConfigOption) Config {
    // Значения по умолчанию
    cfg := Config{
        Port:    8080,
        Timeout: 30,
        Debug:   false,
    }
    // Применяем опции
    for _, opt := range opts {
        opt(&cfg)
    }
    return cfg
}

// Использование:
// cfg := NewConfig(WithPort(9090), WithDebug(true))

Важное замечание

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

Если вы работаете с JSON или YAML конфигами, используйте библиотеки для десериализации — они часто поддерживают значения по умолчанию через теги (например, default:"8080" в пакете github.com/creasty/defaults). Но в чистом Go без внешних зависимостей придерживайтесь фабричных функций.

import "github.com/creasty/defaults"

type Config struct {
    Port    int  `default:"8080"`
    Timeout int  `default:"30"`
    Debug   bool `default:"false"`
}

func main() {
    cfg := &Config{}
    defaults.Set(cfg) // все поля заполнятся значениями из тегов
    fmt.Printf("%+v", cfg) // {Port:8080 Timeout:30 Debug:false}
}