3 ошибки в Turborepo, из-за которых монорепа начинает тормозить и путать команды

3 ошибки в Turborepo, из-за которых монорепа начинает тормозить и путать команды

За красивой схемой пайплайнов часто прячутся очень приземлённые проблемы: лишние пересборки, сломанный cache hit rate и неочевидные зависимости между пакетами.

— Первая ошибка: слишком широкий pipeline. Если задача зависит от всего подряд, Turborepo перестаёт экономить время. Лучше явно разделять build, lint, test и не тащить в граф лишние связи.

— Вторая ошибка: мусор в inputs. Если не вычистить артефакты, конфиги и временные файлы, кэш начинает инвалидироваться без причины. Проверь, что в globalDependencies и inputs попадает только то, что реально влияет на результат.

— Третья ошибка: пакеты живут как отдельные проекты, хотя общие правила уже есть. Когда каждый workspace сам решает, как собирать TS, где лежат алиасы и какие скрипты запускать, монорепа теряет смысл. Нужны единые tsconfig, соглашения по package.json и одинаковые команды.

Есть наблюдение которое стоит проверить: если разработчик не может объяснить, почему задача взялась из cache miss, конфигурация уже слишком сложная.

Начинайте с малого: короткий pipeline, чистые inputs, единые правила для workspace. Тогда Turborepo работает как ускоритель, а не как ещё один слой абстракции.