2026 年 monorepo 依赖图工具怎么选

Raghav Chamadiya更新于 10 分钟
Compared in this post: repowise and
  • Nx
  • Turborepo
  • Madge
  • dependency-cruiser
  • Knip
本页目录

monorepo 依赖图工具怎么选,取决于你要哪一层:驱动构建的包级图用 Nx 或 Turborepo,JS/TS 的循环 import 和规则用 Madge 或 dependency-cruiser,需要带历史和改动影响、覆盖 28 种语言的文件和符号级图用 repowise。 多数团队最后会组合两个,因为包级图和代码级图回答的是不同的问题。

截至 2026 年 10 月的简表:

  • Nx:与 affected 命令、缓存和 CI 绑定的项目图。
  • Turborepo:面向 JavaScript 和 TypeScript 的包与任务图,上手成本低。
  • Madge:最快画出模块图并列出循环 import 的工具。
  • dependency-cruiser:可以让 CI 失败的依赖规则,并能输出图。
  • Knip:用模块图找出未使用的文件、导出和依赖。
  • repowise:带负责人、变更频率和影响范围的文件和符号级图,agent 可通过 MCP 读取。

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

评估方法

我们在 2026 年 10 月 12 日阅读了各工具自己的文档和仓库,按四点比较:

  • 图的粒度:包和任务、文件和模块,还是符号(函数、类、方法)。
  • 循环依赖:能否发现,能否禁止。
  • 语言:单一生态还是多语言。
  • 图的用途:跑任务、执行规则、清理代码,还是理解代码。

对比表

工具图的粒度循环依赖语言主要用途许可证
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.

为什么只有包级图不够

包级图告诉你哪个包依赖哪个包,这个粒度适合构建顺序、缓存和发布顺序。 它到此为止:说不出包内哪个函数承担风险,也说不出哪个文件把环闭合了。

在 monorepo 里,这个缺口很要紧,因为多数架构问题出在包边界以下:沦为杂物间的共享工具、互相 import 的两个模块、所有调用都要经过的一个文件。只画包与包之间箭头的图,会把这些都压成一条线。

所以第一个决定是选层:编排用包级,循环和边界用文件级,重构和改动影响用符号级。下面这些工具处于不同的层,所以很少互相替代。

1. Nx

Nx 是一个 monorepo 平台,它的项目图决定运行哪些任务、哪些结果可以从缓存恢复、一次改动影响哪些项目。 用 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 ref 之间哪些包或任务发生了变化(查询文档)。

  • 亮点: 对 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 包里排查 import 环的最快第一步。
  • 粒度: 文件和模块,限于一个语言家族。
  • 适合你,如果你要一次性审计,或要把图导出到 Graphviz。

4. dependency-cruiser

dependency-cruiser 按你写的规则校验依赖,图是它的副产品。 它支持 JavaScript、TypeScript、CoffeeScript、Vue 和 Svelte,自带循环依赖、孤立模块、生产代码引用开发依赖等规则,可输出 text、dot、HTML、CSV、JSON 和 Mermaid(仓库)。

  • 亮点: 把架构写成配置,代码越界就让 CI 失败。
  • 粒度: 文件和模块。
  • 适合你,如果你要禁止循环和分层违规,而不只是看一眼。

5. Knip

Knip 从真实入口出发读取依赖图,找出 JavaScript 和 TypeScript monorepo 里未使用的文件、导出和依赖。 它有 200 多个插件,让它认识各框架的入口,并支持工作区(knip.dev)。

  • 亮点: 把依赖图变成删除清单。
  • 粒度: 文件和导出。
  • 适合你,如果你的问题是"能删什么",而不是"谁依赖谁"。我们的死代码指南覆盖了 Knip 和其他生态。

6. repowise

repowise 不调用任何模型,构建文件和符号两层依赖图,再把 git 历史、负责人、健康度和改动影响挂到图上。 它在 repowise init 时运行,不需要 API key,对 28 种语言做完整 AST 解析。每条边都记录了它是怎么解析出来的、置信度多少,所以猜出来的边不会冒充确定的边(图层文档)。

bash
pip install repowise
repowise init                                    # 构建依赖图,无需 API key
repowise context src/app.py --include callers    # 谁依赖这个文件,带置信度
repowise serve                                   # 仪表盘:地图、耦合、影响范围
  • 亮点: 回答包级图答不了的问题。地图视图把文件分成社区并画出社区之间的依赖;改动的影响范围列出直接和传递依赖者,以及经常一起改的文件;Break Cycle 重构方案给出翻转后即可消除运行时循环的最小 import 边集合。
  • 图上的历史: 共同变更(co-change)边与 import 分开存放,"在同一次提交里被改"不会污染依赖视图。热点、负责人和耦合见 git 智能指南。
  • Agent: 图通过 ten 个 MCP 工具对外可读。get_context 返回带置信度的调用方和被调用方,get_risk 给一组改动打分,可选开启的 get_dependency_path 返回两个文件之间的最短路径。
  • 工作区: 在多仓库工作区里,可选的 get_architecture 报告循环数量,get_conformance 检查你声明的依赖规则。
  • 适合你,如果你需要跨语言的文件和符号级边,或想在同一张图上看到负责人、变更频率和改动影响。
repowise-dev/repowise 在 repowise 中的地图视图:文件按 ui、server、cli、ingestion、analysis 等社区分组,社区之间的依赖用加权的边画出
repowise-dev/repowise 的依赖地图:每个簇是一个文件社区,粗边是 import 最集中跨越的地方。
repowise 中 call_resolver.py 的影响范围视图:风险仪表、下游文件、共同变更缺口和测试缺口的计数,以及放射状影响图
repowise-dev/repowise 中单个文件的改动影响:一次改动会波及的直接和传递依赖者。

你也可以在浏览器里查看真实索引:打开 FastAPI 架构视图,或浏览在线示例。

怎么选

先看你眼前的第一个问题,再叠加第二层。

你的情况先用
构建和 CI 慢,想只跑受影响的部分Nx 或 Turborepo
要在 JS/TS 包里找一个 import 环Madge
想让代码越界时 CI 失败dependency-cruiser
想删掉没人用的代码Knip
仓库是多语言,或需要负责人和改动影响repowise
AI agent 需要结构化的仓库上下文通过 MCP 使用 repowise

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 的重构视图:按文件大小和被 import 次数画出的散点图,包含 Split File、Break Cycle、Extract Class 和 Move Method 方案,下方是排序列表
repowise-dev/repowise 的重构方案排序,其中包含 Break Cycle。每个点是一个文件,位置由它的大小和被多少代码 import 决定。

常见问题

monorepo 最好的依赖图工具是哪个?
取决于你要哪一层。驱动构建的包级图用 Nx 或 Turborepo,JS/TS 的循环 import 和规则用 Madge 或 dependency-cruiser,带历史和改动影响、跨多种语言的文件和符号级图用 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 是连接 AI 应用与工具和数据的开放标准(modelcontextprotocol.io)。依赖图通过它暴露后,agent 可以直接查询调用方、影响范围和两个文件之间的路径,而不是从原始文件文本里猜。
可以在私有 monorepo 上运行 repowise 吗?
可以。开源 CLI(AGPL-3.0)在本地运行:pip install repowise && repowise init,依赖图在你的机器上构建,不调用模型。托管产品上的私有仓库属于 Pro。

索引你的仓库,免费