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 任务、缓存、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.
为什么只有包级图不够
包级图告诉你哪个包依赖哪个包,这个粒度适合构建顺序、缓存和发布顺序。 它到此为止:说不出包内哪个函数承担风险,也说不出哪个文件把环闭合了。
在 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)(仓库)。
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 解析。每条边都记录了它是怎么解析出来的、置信度多少,所以猜出来的边不会冒充确定的边(图层文档)。
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检查你声明的依赖规则。 - 适合你,如果你需要跨语言的文件和符号级边,或想在同一张图上看到负责人、变更频率和改动影响。


你也可以在浏览器里查看真实索引:打开 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 与其他代码智能工具的对比见对比页面。
查找循环依赖
循环通常意味着:共享模块沦为杂物间、包边界划错了,或两个模块负责同一个概念。 跨工具通用的流程:
- 先跑包级图,排除包之间的循环。
- 对可疑的包做文件级检查(
madge --circular或 dependency-cruiser 规则)。 - 取最小的环,问这些文件归谁、是不是热点。
- 在风险最低的边上打破循环。
后两步是 repowise 能帮上忙的地方:它的重构视图基于同一张图给 Break Cycle 方案排序,你可以从翻转成本最低的边开始。

常见问题
- 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。


