Чем монорепозитории отличаются от мультирепозиториев?

Монорепозиторий (monorepo) — это подход, при котором код нескольких проектов, библиотек и сервисов хранится в одном репозитории системы контроля версий. Мультирепозиторий (multirepo) — противоположный подход, где каждый проект живёт в отдельном репозитории. Оба варианта решают одну задачу: как организовать исходный код, но с разными компромиссами.

Ключевые различия

• Единый источник правды: в монорепо все изменения видны сразу, легко делать атомарные коммиты, затрагивающие несколько проектов.
• Переиспользование кода: общие библиотеки лежат рядом, их можно импортировать напрямую без публикации в реестр пакетов.
• Независимость релизов: в мультирепо каждый проект версионируется и деплоится отдельно, что упрощает изоляцию команд.
• Сложность инструментов: монорепо требует инструментов вроде Nx, Turborepo, Bazel или Lerna для эффективной сборки и кэширования.
• Размер репозитория: монорепо быстро растёт, что замедляет клонирование и операции Git без специальных оптимизаций.

Пример структуры монорепозитория

my-monorepo/
  packages/
    ui-kit/        # общая библиотека компонентов
    utils/         # общие утилиты
  apps/
    web/           # веб-приложение
    mobile/        # мобильное приложение
  package.json     # workspace-конфигурация

Когда что выбирать

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

Итог: монорепозиторий стоит применять для связанных проектов с общей кодовой базой и едиными процессами CI/CD, а мультирепозиторий — для независимых команд и сервисов с разными технологическими стеками и графиками релизов.