Ответ.

Go поддерживает функцию init для выполнения кода инициализации до начала main(). При запуске программы Go компилятор автоматически вызывает все функции init, объявленные в каждом пакете, после инициализации переменных пакета.

История вопроса: необходимость однократной подготовки состояния пакета до его использования.

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

Решение:

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

Пример кода:

package example
import "fmt"

var Cfg string = "default"

func init() {
    fmt.Println("example init")
    Cfg = "configured"
}

Ключевые особенности:

Все init-функции в пакете вызываются после инициализации глобальных/пакетных переменных.
Если несколько init-функций, порядок их вызова тот же, что и порядок объявления в файле.
Порядок инициализации пакетов определяется деревом импортов — сначала зависимости, потом сам пакет.

Вопросы с подвохом.

Можно ли определить больше одной init-функции в одном файле?

Да, допускается несколько init-функций — они вызовутся в порядке их объявления.

Что произойдет, если пакет импортируется только побочно (через _ "package")?

Выполнятся только init функции и инициализация переменных этого пакета.

Init-функции могут возвращать значение или ошибку?

Нет. Сигнатура init неизменна: func init(), без параметров и возвращаемых значений.

Типовые ошибки и анти-паттерны

Использование init для сложной бизнес-логики или тяжёлой инициализации.
Скрытое изменение переменных через init в разных пакетах, приводящее к непредсказуемому поведению.
Множественные init-функции без необходимости.

Пример из жизни

Негативный кейс

Крупный проект полагался на сложные init-функции, инициализирующие глобальные состояния с зависимостями между пакетами. Причиняло плавающие ошибки запуска.

Плюсы:

Упрощённая инициализация (нет явного вызова в main).

Минусы:

Зависимость от порядка и доступа затрудняла тестирование и отладку.

Позитивный кейс

Init используется только для базовых или test-specific задач, остальное вынесено в явные функции, вызываемые из main(). Очевиден порядок запуска, простота тестирования.