Только не экспортируй приватные типы в Go


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


Неэкспортируемые типы в Go: откуда все началось

При переходе в мир Go из классических объектно-ориентированных языков, таких как Java или PHP, многие разработчики привыкли к использованию классов и автоматической инициализации объектов при вызове конструктора.
Но структуры в Go – это не то же самое, что классы и объекты в других языках. Они играют похожую роль, но не такую же!
Кстати, узнайте больше о нашем подходе в веб-разработке, также рекомендуем посмотреть наши кейсы – они точно вас удивят.

Проблемы с экспортом приватных типов

Основная проблема с экспортированием приватных типов заключается в том, что это нарушает принцип инкапсуляции.
Само название "неэкспортируемая структура" говорит: она для внутреннего использование пакета. И нужна, чтобы потребители кода работали ТОЛЬКО с экспортируемыми типами. Это инкапсуляция, которая позволяет скрывать то, куда не надо лезть извне! То, что работает сложным образом, а также может изменяться с новыми версиями пакета. Поэтому делать такое - то же самое, что пытаться сделать что-то маркируемое "несъедобное" - съедобным. Это забивать гвозди перфоратором. Если программист так делает, то он просто не понимает зачем это нужно.

Написание структур, которые не требуют инициализации.

Примеры: sync.Mutex, time.Time, sync.WaitGroup и другие.
При дефолтной инициализации они будут работать корректно. Можно использовать именованные конструкторы для инициализации в нужное состояние: time.Now(), time.Parse(). Это идеальный подход! Но такого можно достичь не во всех случаях.

Сложный доменный сервис может потребовать более глубокой инициализации

Например, инъецировании зависимостей (Config, Logger, Repo, NetClient и т.п.). В таком случае создаётся именованный конструктор и структура с приватными полями, в которые вообще ничего нельзя записать при базовой инициализации. В этом случае зависимости, конфигурация и прочее проверяются в конструкторе, который может вернуть ошибку.
NewDomainService(c Config, d Dependencies) (*DomainService, error)
У таких сервисов в сигнатуре всегда будут методы, которые выполняют какую-то доменную функцию:
  • Start(ctx context.Context) error
  • Process(ctx context.Context) error
  • Execute(ctx context.Context) error
  • .....
Если сервис не был корректно инициализирован, то они вернут ошибку. В 99% случаев такие сервисы и так могут вернуть разные ошибки по десяткам причин. Так что аргумент "мне лень обрабатывать ошибки" - звучит плохо.

Обрабатывать ошибки – это подход Go.

Это делается двумя строчками, которые генерируются IDE автоматически уже. И именно это позволяет сразу понимать узкие места своего кода, возможные ошибки и заставляет думать что с ними делать. И ничего страшного при этом не случиться.
Её обработает потребитель и в случае неверной инициализации программист увидит ошибку ещё на уровне тестов своего модуля, если, конечно, он их пишет. В худшем случае всё развалится при попытке запуска приложения в первый же тестовый прогон.
Если же подобная проблема (мой сервис не был инициализирован) приводит к "каким-то страшным критическим вещам", например, удалилась база данных, отформатировался диск, перевелись биткоины в несуществующий кошелёк, то у вас проблемы с написанием сервисом! Проблема в Вас, а не в том, кто использует ваш код! Потому что так случаться никогда не должно!

Защита от неведомых проблем с "глупыми потребителя" – жди проблем

А именно:
  1. Вы не сможете построить нормальную архитектуру приложения. Потому что вы просто не можете использовать этот приватный тип в слоях верхнего уровня. Например, если это репозиторий, или какой-то другой доменный сервис, то его надо описать в интерфейсе потребителя. Но вы не можете этого сделать, потому что это приватный тип! Вы просто не сможете им типизировать что-то за пределами его пакета! Поэтому DI работать не будет.
  2. Если вы хотите подсунуть его в интерфейсный тип какого-то потребителя, то вам понадобится следующее:

    -ServiceLocator или ApplicationRegistry - это объект верхнего уровня архитектуры, который хранит ссылки на основные сервисы. Он должен знать хранить инициализацию этого объекта.

    -IoС - тут будет необходимость забиндить реализацию для интерфейса, который будет автоматически инъецироваться при билдинге объектов. Будете ли вы это делать руками, использовать Wire или FX, вам всё равно надо написать, например, FX Show конструктор для этого типа, а потом забиндить его к нужным интерфейсам. Всё это невозможно сделать с приватными типами.
  3. Вы не сможете использовать документацию GoDoc, потому что приватные типы там не описываются для внешнего использования, что абсолютно логично!
  4. Противоречит идиоматике языка и путает других разработчиков нестандартным и неправильным подходом.

Вместо заключения

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

Обсудим ваш проект?

Узнали в статье свою задачу? Расскажите о ней — покажем похожие кейсы, оценим сроки и предложим решение под ваш бюджет. Первая консультация — бесплатно.
Напишите нам

Другие статьи автора

Git Worktree: параллельная разработка с AI-агентами
Programming 13 мин чтения

Git Worktree: параллельная разработка с AI-агентами

Git worktrees позволяют нескольким AI-агентам работать с одним репозиторием одновременно благодаря изолированным рабочим директориям. Руководство по настройке,...

Выравнивание памяти в Go: как мы экономим 40% RAM
Golang 10 мин чтения

Выравнивание памяти в Go: как мы экономим 40% RAM

Практическое руководство по выравниванию структур Go из опыта Webdelo. Примеры кода из финтех- и корпоративных проектов, таблицы сравнения затрат, устранение fa...

Компоненты и утилиты Tailwind: каскадные слои CSS
HTML 16 мин чтения

Компоненты и утилиты Tailwind: каскадные слои CSS

Руководство по управлению каскадом в Tailwind CSS для корпоративных проектов. Четыре типичные проблемы, стратегия переопределения через слои, реальные примеры д...

Похожие статьи

Как выбрать домен для сайта
SEO 10 мин чтения

Как выбрать домен для сайта

Выбор домена – важный начальный этап веб-разработки и его нужно сделать правильно с первого раза. Знаете ли вы, что историю домена нужно проверять как сыщик 🕵️‍...

Как автоматизация бизнеса повышает прибыль и экономит время на решение рутинных задач и бухгалтерских вопросов
SEO 12 мин чтения

Как автоматизация бизнеса повышает прибыль и экономит время на решение рутинных задач и бухгалтерских вопросов

Как автоматизация бизнеса влияет на управление сайтом, эффективность и прибыль компании? Автоматизация рутинных процессов и клиентског...

Темная сторона контент менеджмента
SEO 10 мин чтения

Темная сторона контент менеджмента

Что такое контент-менеджмент? Проще говоря, это системная работа по развитию сайта: от планирования публикаций до наполнения его полез...

Нейросети лишат веб-разработчиков работы?
Programming 7 мин чтения

Нейросети лишат веб-разработчиков работы?

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

Сколько стоит создать сайт в 2025-2026 году
Programming 17 мин чтения

Сколько стоит создать сайт в 2025-2026 году

Цены на создание сайтов — как погода весной: меняются каждый день и зависят от десятков факторов. В 2025-2026 году разброс особенно за...

Chrome DevTools MCP: отладка производительности с ИИ
Programming 15 мин чтения

Chrome DevTools MCP: отладка производительности с ИИ

Chrome DevTools MCP подключает ИИ-агентов к DevTools браузера для диагностики производительности. Руководство: отладка с LCP-субчастями, регрессионные проверки,...

Navigation API: руководство по роутингу SPA (2026)
SEO 24 мин чтения

Navigation API: руководство по роутингу SPA (2026)

Практическое руководство по Navigation API как новому стандарту браузерного роутинга SPA. Корпоративные паттерны контроля доступа, отмены запросов, наблюдаемост...

cookies Мы используем Cookie

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

Необходимые (обязательные)

Обеспечивают работу сайта (навигация, доступ к защищённым разделам). Всегда включены и могут быть изменены только в настройках браузера.

Аналитические

Помогают нам понять, как вы используете сайт, чтобы улучшать сервис. Не собирают личные данные. Для аналитики мы используем ряд инструментов.

Маркетинговые / Рекламные

Используются для показа персонализированной рекламы и измерения эффективности рекламных кампаний.