Соглашения по именованию констант в Go: CamelCase, ALL_CAPS или что-то ещё?

Основное правило: CamelCase, а не ALL_CAPS

В Go действует простое правило: используйте CamelCase для всех констант, как и для любых других экспортируемых (публичных) идентификаторов. Привычка из других языков писать константы заглавными буквами с подчёркиваниями (ALL_CAPS) в Go не приветствуется.

Вот правильный пример для вашего случая:

package config

const MaxRetries = 3
const DefaultTimeoutSeconds = 30
const DatabaseURL = "localhost:5432"

Для неэкспортируемых (приватных) констант используйте lowerCamelCase:

const maxRetries = 3
const defaultTimeout = 30

Исключения: когда используют ALL_CAPS

Несмотря на общее правило, есть несколько исторических и технических исключений, которые вы могли заметить в стандартной библиотеке:

• Константы из C-шного наследия — например, O_RDONLY, O_WRONLY, O_CREAT из пакета os. Они были перенесены из Unix/POSIX API, где такие имена уже устоялись десятилетиями. Это исключение, а не правило.
• Константы для масок и битовых флагов — иногда используют FlagA, FlagB в CamelCase, но если они часть устоявшегося C-стиля, могут остаться в ALL_CAPS.
• Константы, имитирующие системные вызовы — например, SIGINT, SIGTERM в пакете os/signal. Это тоже дань историческому контексту.

Важно понимать: для новых проектов и новых констант используйте CamelCase. Исключения оправданы только когда вы напрямую работаете с унаследованными C-интерфейсами или системными вызовами.

Почему так, а не иначе?

В Go дизайн языка намеренно избегает "визуального шума". ALL_CAPS в Go считается менее читаемым, особенно когда констант много. Правило простое: экспортируемое = с большой буквы, неэкспортируемое = с маленькой. И это относится ко всем идентификаторам: функциям, типам, переменным, константам.

Если вы пишете библиотеку или приложение с нуля, забудьте про ALL_CAPS. Используйте:

const (
    // Экспортируемые
    MaxConnections = 100
    DefaultPort    = 8080

    // Неэкспортируемые
    internalRetryLimit = 3
    secretKey          = "supersecret"
)

Так ваш код будет соответствовать официальным рекомендациям Effective Go и проходить линтеры (например, golint или revive) без предупреждений.

Дополнительный совет: группировка констант

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

type Status int

const (
    StatusActive   Status = iota // 0
    StatusInactive               // 1
    StatusPending                // 2
)

В этом случае имена тоже в CamelCase, а не в ALL_CAPS.

const (
    EnvDatabaseURL  = "DATABASE_URL"    // имя переменной окружения
    EnvAPIKey       = "API_KEY"
    EnvLogLevel     = "LOG_LEVEL"
)

const (
    HeaderContentType     = "Content-Type"     // CamelCase — имя заголовка
    HeaderAuthorization   = "Authorization"
    StatusOK             = 200
    StatusNotFound       = 404
)