Лучшие инструменты графа зависимостей для монорепозитория в 2026 году

Raghav ChamadiyaОбновлено 10 мин
Compared in this post: repowise and
  • Nx
  • Turborepo
  • Madge
  • dependency-cruiser
  • Knip
Содержание

Какой инструмент графа зависимостей лучший для монорепозитория, зависит от нужного слоя: Nx или Turborepo для графа пакетов, который управляет сборкой; Madge или dependency-cruiser для циклов и правил импортов в JS и TS; repowise для графа файлов и символов с историей и оценкой влияния изменений для 28 языков. Большинство команд в итоге берут два инструмента, потому что граф пакетов и граф кода отвечают на разные вопросы.

Краткий список на октябрь 2026 года:

  • Nx: граф проектов, связанный с командами affected, кэшем и CI.
  • Turborepo: граф пакетов и задач для JavaScript и TypeScript, простой в настройке.
  • Madge: самый быстрый способ нарисовать граф модулей и вывести циклические импорты.
  • dependency-cruiser: правила зависимостей, по которым можно ронять CI, и вывод графа.
  • Knip: граф модулей, по которому ищут неиспользуемые файлы, экспорты и зависимости.
  • repowise: граф файлов и символов с владельцами, частотой изменений и радиусом поражения, доступный агентам по MCP.

We build repowise, so weigh our entry accordingly. The measurements we publish about it, with their methods, are on the benchmarks page.

Как мы сравнивали

12 октября 2026 года мы прочитали документацию и репозиторий каждого инструмента и сравнили их по четырём признакам:

  • Глубина графа: пакеты и задачи, файлы и модули или символы (функции, классы, методы).
  • Циклы: умеет ли находить циклическую зависимость и умеет ли её запрещать.
  • Языки: одна экосистема или много.
  • Для чего граф: запуск задач, соблюдение правил, уборка или понимание кода.

Сравнительная таблица

ИнструментГлубина графаЦиклические зависимостиЯзыкиОсновная задачаЛицензия
NxПроекты и задачиЧерез обязательные границыВ первую очередь TypeScript; плагины для Gradle, Maven, .NET, Go и другихAffected-задачи, кэш, CIMIT
TurborepoПакеты и задачиНе его задачаJavaScript и TypeScriptКонвейеры задач и кэшMIT
MadgeФайлы и модули--circularJavaScript (AMD, CommonJS, ES modules), CSS-препроцессорыБыстрый граф модулейMIT
dependency-cruiserФайлы и модулиПравила, роняющие сборкуJavaScript, TypeScript, Vue, SvelteСоблюдение правил и вывод графаMIT
KnipФайлы и экспортыНе его задачаJavaScript и TypeScriptНеиспользуемый код и зависимостиISC
repowiseФайлы и символы, 17 типов рёберПланы Break Cycle; циклы в архитектурном представлении воркспейса28 языков с полным разбором ASTПонимание кода и влияние измененийAGPL-3.0

Scroll the table sideways to see every column.

Почему графа пакетов недостаточно

Граф пакетов показывает, какой пакет от какого зависит, и это правильный уровень для порядка сборки, кэша и порядка релиза. Дальше он не идёт: не скажет, какая функция внутри пакета несёт риск и какой файл замыкает цикл.

В монорепозитории этот разрыв важен, потому что большая часть архитектурных проблем лежит ниже границ пакетов: общий модуль, ставший свалкой, два модуля, импортирующие друг друга, один файл, через который проходит всё. Граф, рисующий только стрелки между пакетами, сводит всё это к одной линии.

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

1. Nx

Nx это платформа для монорепозиториев, у которой граф проектов решает, какие задачи запускать, что можно взять из кэша и каких проектов касается изменение. Граф открывается командой npx nx graph, а nx affected запускает задачи только для затронутых проектов.

  • Сильная сторона: граф напрямую встроен в работу CI. Плагины Nx находят задачи для Vite, Webpack, Jest, Gradle, Maven, .NET и Go, так что граф не ограничен JavaScript, а npx nx init подключается к существующему воркспейсу npm, pnpm или yarn (репозиторий).
  • Глубина: проекты и задачи. Он описывает связи между проектами воркспейса, а не символы внутри них.
  • Берите, если хотите, чтобы граф управлял affected-сборками, кэшем и тегами границ, или воркспейс уже на Nx.

2. Turborepo

Turborepo выводит граф пакетов из менеджера пакетов, а граф задач из конфигурации конвейера. turbo query выполняет GraphQL-запросы к репозиторию, turbo ls перечисляет пакеты, а turbo query affected показывает, какие пакеты или задачи изменились между двумя git-ссылками (справочник по query).

  • Сильная сторона: минимум церемоний для воркспейсов на JavaScript и TypeScript, с кэшем и конвейерами задач.
  • Глубина: пакеты и задачи.
  • Берите, если воркспейс ложится на пакеты npm, pnpm или yarn, а граф нужен, чтобы ускорить сборку и тесты.

3. Madge

Madge строит визуальный граф зависимостей модулей и перечисляет циклические. Он читает AMD, CommonJS и ES modules, а также Sass, Stylus и Less, и поддерживает --circular, --orphans, --leaves и --image для вывода в SVG или PNG (репозиторий).

bash
npx madge --circular --extensions ts,tsx src/
npx madge --image graph.svg src/
  • Сильная сторона: самый быстрый первый заход на цикл импортов в пакете JS или TS.
  • Глубина: файлы и модули в рамках одного семейства языков.
  • Берите, если нужен разовый аудит или граф для экспорта в Graphviz.

4. dependency-cruiser

dependency-cruiser проверяет зависимости по написанным вами правилам, а граф рисует попутно. Он работает с JavaScript, TypeScript, CoffeeScript, Vue и Svelte, содержит правила для циклических зависимостей, модулей-сирот и импорта dev-зависимостей из продакшен-кода, а вывод умеет в text, dot, HTML, CSV, JSON и Mermaid (репозиторий).

  • Сильная сторона: архитектура записана конфигом, а CI падает, когда код выходит за границу.
  • Глубина: файлы и модули.
  • Берите, если хотите запрещать циклы и нарушения слоёв, а не только смотреть на них.

5. Knip

Knip читает граф зависимостей от настоящих точек входа и находит неиспользуемые файлы, экспорты и зависимости в монорепозиториях на JavaScript и TypeScript. Более 200 плагинов объясняют ему точки входа фреймворков, и он понимает воркспейсы (knip.dev).

  • Сильная сторона: превращает граф в список на удаление.
  • Глубина: файлы и экспорты.
  • Берите, если вопрос звучит как «что можно удалить», а не «что от чего зависит». Руководство по мёртвому коду разбирает Knip и другие экосистемы.

6. repowise

repowise без вызовов модели строит двухуровневый граф файлов и символов и добавляет к нему историю git, владельцев, здоровье кода и влияние изменений. Он запускается во время repowise init, не требует API-ключа и разбирает 28 языков в полный AST. Каждое ребро хранит, как оно было разрешено и с какой уверенностью, поэтому догадка никогда не выдаётся за факт (документация слоя графа).

bash
pip install repowise
repowise init                                    # строит граф, ключ API не нужен
repowise context src/app.py --include callers    # кто зависит от файла, с уверенностью
repowise serve                                   # панель: карта, связность, радиус поражения
  • Сильная сторона: вопросы, на которые граф пакетов не отвечает. Карта группирует файлы в сообщества и рисует зависимости между ними; радиус поражения изменения перечисляет прямых и транзитивных зависимых и файлы, которые обычно меняются вместе с ним; планы Break Cycle называют минимальный набор рёбер импорта, который нужно перевернуть, чтобы убрать цикл времени выполнения.
  • История на графе: рёбра совместных изменений (co-change) хранятся отдельно от импортов, поэтому «правились в одном коммите» не загрязняет граф зависимостей. О горячих точках, владельцах и связности читайте в руководстве по git-аналитике.
  • Агенты: граф доступен по MCP через ten инструментов. get_context возвращает вызывающих и вызываемых с уверенностью, get_risk оценивает набор изменений, а включаемый отдельно get_dependency_path возвращает кратчайший путь между двумя файлами.
  • Воркспейсы: в мультирепозиторном воркспейсе включаемый get_architecture сообщает число циклов, а get_conformance проверяет объявленные вами правила зависимостей.
  • Берите, если нужны рёбра на уровне файлов и символов для нескольких языков или владельцы, частота изменений и влияние изменений на одном графе.
Карта в repowise для repowise-dev/repowise: файлы сгруппированы в сообщества ui, server, cli, ingestion, analysis и другие, зависимости между сообществами нарисованы взвешенными рёбрами
Карта зависимостей repowise-dev/repowise: каждый кластер это сообщество файлов, а толстые рёбра показывают, где чаще всего пересекаются импорты.
Радиус поражения в repowise для call_resolver.py: индикатор риска, число зависимых файлов, пробелов совместных изменений и пробелов в тестах, радиальная карта влияния
Влияние изменения одного файла в repowise-dev/repowise: прямые и транзитивные зависимые, которых затрагивает правка.

Реальный индекс можно посмотреть в браузере: откройте архитектуру FastAPI или живые примеры.

Как выбрать

Начните с первой проблемы, потом добавьте второй слой.

Ваша ситуацияНачните с
Сборка и CI медленные, нужны только affected-запускиNx или Turborepo
Нужно найти один цикл импортов в пакете JS или TSMadge
Хотите, чтобы CI падал при нарушении границdependency-cruiser
Хотите удалить то, до чего ничто не доходитKnip
Репозиторий на нескольких языках или нужны владельцы и влияние измененийrepowise
Агенту ИИ нужен структурированный контекст репозиторияrepowise по MCP

Scroll the table sideways to see every column.

Типичная связка: Nx или Turborepo запускает работу, dependency-cruiser охраняет границы модулей в CI, а repowise показывает, где риск и что рефакторить. Если требовать от одного инструмента всех трёх задач, граф расплывается. Как repowise соотносится с другими инструментами анализа кода, смотрите на страницах сравнения.

Поиск циклических зависимостей

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

  1. Сначала постройте граф пакетов, чтобы исключить цикл между пакетами.
  2. Проверьте подозрительный пакет на уровне файлов (madge --circular или правило dependency-cruiser).
  3. Возьмите самый короткий цикл и выясните, кто владеет этими файлами и не горячие ли они точки.
  4. Разорвите цикл по самому безопасному ребру.

Последние два шага это зона repowise: его представление рефакторинга ранжирует планы Break Cycle по тому же графу, так что можно начать с ребра, которое дешевле всего перевернуть.

Представление рефакторинга в repowise: диаграмма рассеяния файлов по размеру и числу импортирующих, планы Split File, Break Cycle, Extract Class и Move Method и ранжированный список ниже
Ранжированные планы рефакторинга для repowise-dev/repowise, среди них Break Cycle. Каждая точка это файл, положение зависит от его размера и от того, сколько кода его импортирует.

Частые вопросы

Какой инструмент графа зависимостей лучший для монорепозитория?
Это зависит от слоя. Nx или Turborepo для графа пакетов, управляющего сборкой; Madge или dependency-cruiser для циклов и правил импортов в JavaScript и TypeScript; repowise для графа файлов и символов с историей и оценкой влияния изменений для многих языков.
Чем граф пакетов отличается от графа символов?
Граф пакетов показывает связи между пакетами воркспейса и нужен для порядка сборки, кэша и релизов. Граф символов отслеживает файлы, классы, функции и методы и нужен для рефакторинга, оценки влияния изменений и поиска файла, замыкающего цикл.
Какой инструмент быстрее всего находит циклические зависимости?
Обычно Madge: npx madge --circular src/ выводит циклы. Если цикл должен ронять сборку, лучше подходит dependency-cruiser, потому что он применяет правила в CI.
Находят ли Nx и Turborepo циклические зависимости?
Nx может принудительно держать границы проектов через теги, что предотвращает многие циклы. Граф Turborepo существует для запуска задач, а поиск циклов не его задача. Для циклов между файлами внутри пакета добавьте Madge или dependency-cruiser.
Работают ли эти инструменты вне JavaScript?
Madge, dependency-cruiser, Knip и Turborepo нацелены на JavaScript и TypeScript. Nx выходит дальше через плагины для Gradle, Maven, .NET и Go. repowise разбирает 28 языков в полный AST, поэтому у репозитория на нескольких языках один граф.
Зачем графу зависимостей MCP?
MCP это открытый стандарт подключения ИИ-приложений к инструментам и данным (modelcontextprotocol.io). Граф, доступный через него, позволяет агенту запрашивать вызывающих, влияние изменений и путь между двумя файлами, а не угадывать по тексту файлов.
Можно ли запускать repowise на приватном монорепозитории?
Да. Открытый CLI (AGPL-3.0) работает локально: pip install repowise && repowise init, граф строится на вашей машине без вызовов модели. Приватные репозитории в хостируемом продукте входят в Pro.

Проиндексируйте свой репозиторий бесплатно