Содержание
Какой инструмент графа зависимостей лучший для монорепозитория, зависит от нужного слоя: 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-задачи, кэш, CI | MIT |
| Turborepo | Пакеты и задачи | Не его задача | JavaScript и TypeScript | Конвейеры задач и кэш | MIT |
| Madge | Файлы и модули | --circular | JavaScript (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 (репозиторий).
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. Каждое ребро хранит, как оно было разрешено и с какой уверенностью, поэтому догадка никогда не выдаётся за факт (документация слоя графа).
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проверяет объявленные вами правила зависимостей. - Берите, если нужны рёбра на уровне файлов и символов для нескольких языков или владельцы, частота изменений и влияние изменений на одном графе.


Реальный индекс можно посмотреть в браузере: откройте архитектуру FastAPI или живые примеры.
Как выбрать
Начните с первой проблемы, потом добавьте второй слой.
| Ваша ситуация | Начните с |
|---|---|
| Сборка и CI медленные, нужны только affected-запуски | Nx или Turborepo |
| Нужно найти один цикл импортов в пакете JS или TS | Madge |
| Хотите, чтобы CI падал при нарушении границ | dependency-cruiser |
| Хотите удалить то, до чего ничто не доходит | Knip |
| Репозиторий на нескольких языках или нужны владельцы и влияние изменений | repowise |
| Агенту ИИ нужен структурированный контекст репозитория | repowise по MCP |
Scroll the table sideways to see every column.
Типичная связка: Nx или Turborepo запускает работу, dependency-cruiser охраняет границы модулей в CI, а repowise показывает, где риск и что рефакторить. Если требовать от одного инструмента всех трёх задач, граф расплывается. Как repowise соотносится с другими инструментами анализа кода, смотрите на страницах сравнения.
Поиск циклических зависимостей
Цикл обычно означает одно из трёх: общий модуль превратился в свалку, граница пакета проведена неверно или два модуля владеют одним понятием. Порядок действий, который работает с любыми инструментами:
- Сначала постройте граф пакетов, чтобы исключить цикл между пакетами.
- Проверьте подозрительный пакет на уровне файлов (
madge --circularили правило dependency-cruiser). - Возьмите самый короткий цикл и выясните, кто владеет этими файлами и не горячие ли они точки.
- Разорвите цикл по самому безопасному ребру.
Последние два шага это зона 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.


