2026 年最好的代码可视化工具:依赖图、代码地图与架构图

Raghav Chamadiya更新于 10 分钟
Compared in this post: repowise and
  • Structurizr
  • CodeScene
  • GitDiagram
  • Madge
  • dependency-cruiser
  • Sourcegraph
本页目录

最好的代码可视化工具取决于你需要哪种图。 想把 C4 架构图当代码维护,用 Structurizr;想看 JavaScript 和 TypeScript 的导入图与循环依赖,用 Madge 或 dependency-cruiser;想看热点地图,用 CodeScene;想快速给公开仓库画个草图,用 GitDiagram;想要一张由代码解析而来、覆盖 28 种语言、并把归属和 git 历史放在同一张图上的地图,用 repowise。

工具画什么图从哪来价格(2026 年 10 月)
repowise依赖图、架构图、耦合、影响范围、归属、热点解析代码并挖掘 git 历史,不需要模型开源可自托管;托管版免费支持两个公开仓库
StructurizrC4 系统、容器、组件、部署视图你用 DSL 写模型命令行免费;服务端需要许可
CodeScene热点、代码健康度、团队与知识分布分析代码和 git 历史每位活跃作者每月 18 欧元起
GitDiagram一张交互式 Mermaid 架构图LLM 读取目录树、README 和部分源码免费,MIT 许可
MadgeJS 模块图、循环导入解析导入语句免费开源
dependency-cruiserJS 和 TS 依赖图,加 CI 规则检查按你的规则解析导入免费,MIT 许可
Sourcegraph跨仓库搜索与导航,含 Insights为代码建索引企业版,约每年 1.6 万美元起

Scroll the table sideways to see every column.

我们如何评估

画出节点和边是最容易的部分。我们看四点:

  • 是否保持最新。 图是从仓库重新生成的,还是靠人重画?手绘图只在画完那天是准的。
  • 解析还是推断。 每条边来自真实存在的代码,还是模型对部分代码的理解?做决定需要前者。
  • 粒度。 能否在仓库、包、文件、符号之间切换?
  • 能帮你做什么。 循环依赖、归属、风险和历史,能把一张图变成一个决定。

各个工具画什么?

repowise

repowise 在 repowise init 时构建文件和符号两层的图,不调用模型,不联网。每条边都记录产生它的策略和置信度,所以猜测出来的边不会被当成确定的边展示(见图文档)。repowise update 让它保持最新。

repowise-dev/repowise 仓库的架构地图,文件按 server、cli、ui、ingestion 等社区分组,并画出它们之间的导入关系
repowise-dev/repowise 的架构地图:视图中有 1,308 个文件,按社区分组,边包括导入、共同变更和低置信度链接。选两个文件可以追踪它们之间的路径。

repowise serve 提供 Graph、Architecture、Coupling、Blast radius、Knowledge graph 和 Dead code 视图。C4 风格的架构视图可以从系统层一路下钻到文件,任何已索引的公开仓库都有,例如 FastAPI 架构视图。

repowise 仓库中修改 call_resolver.py 的影响范围视图,用影响图画出下游文件
修改 call_resolver.py 的影响范围:1 个直接依赖和 52 个传递依赖,以影响图呈现。

同一张图也通过 MCP 提供给智能体:get_context(targets, include=["callers"]) 返回依赖、被依赖方和带置信度的调用方,get_symbol(id, depth) 返回经过核验的符号源码,get_risk、get_change_risk 和 get_dead_code 读取同一份索引。MCP 工具共 ten 个。

适合你,如果 你希望图保持最新、带有归属和历史,并且能被 Claude Code 或 Cursor 查询。安装:pip install repowise,然后运行 repowise init。

Structurizr

Structurizr 是 C4 模型的参考实现,由 C4 的作者开发。你用 Structurizr DSL 写一个工作区,它从同一个模型生成系统全景、系统上下文、容器、组件、动态和部署视图,并支持 Git。命令行工具免费;使用预编译二进制的服务端需要许可(截至 2026 年 10 月)。

它不读你的代码,这正是它的用意:图表达团队的设计意图,像代码一样被评审。适合你,如果 你的主要产出是供人评审的架构文档。

CodeScene

CodeScene 展示风险在哪里:热点(频繁修改且质量有问题的文件)、1 到 10 分的 CodeHealth,以及团队和知识分布。Standard 每位活跃作者每月 18 欧元,Pro 为 27 欧元,按年计费,提供云端和本地部署,开源项目可用免费的社区版(截至 2026 年 10 月)。

适合你,如果 你要回答"重构精力该投在哪",并且想要带企业治理能力的商业产品。

GitDiagram

GitDiagram 是 MIT 许可的工具,把 GitHub 仓库变成交互式架构图。把 GitHub 地址里的 "hub" 换成 "diagram" 即可;私有仓库需要 GitHub token。它还提供远程 MCP 服务 gitdiagram.com/mcp,智能体可以直接读取图。

图由 LLM 根据目录树、README 和部分源码生成,所以它是一份信息较充分的摘要,而不是解析出来的图。适合你,如果 你想最快地对一个陌生公开仓库有个可读的第一印象。

Madge

Madge 绘制 JavaScript 模块依赖图(AMD、CommonJS、ES6,以及 Sass、Stylus、Less),并标出循环依赖。输出 SVG、DOT 或 JSON,只有生成图片时才需要 Graphviz:npm -g install madge。

适合你,如果 你想用一条命令得到 JS 导入图或检查循环依赖。

dependency-cruiser

dependency-cruiser 校验并可视化 JavaScript 和 TypeScript 项目的依赖(含 JSX、TSX、Vue、Svelte),代码违反你写的规则时让 CI 失败,例如"ui/ 不能导入 db/"。支持输出 DOT、HTML、CSV、JSON 和 Mermaid。

适合你,如果 你需要在 JS 或 TS 仓库的 CI 中强制执行分层规则。

Sourcegraph

Sourcegraph 提供跨所有仓库的代码搜索和导航,带 Insights 和 MCP 服务。它以企业版方式销售,约每年 1.6 万美元起(截至 2026 年 10 月)。适合你,如果 问题是"在上百个仓库里查找和导航",而不是"画出这一个仓库"。

CodeSee、Sourcetrail 去哪了

CodeSee 做过交互式代码地图和评审地图,GitKraken 在 2024 年 5 月收购了它,它不再单独销售。Sourcetrail 已被作者在 2021 年底归档。今天要实时地图,用 repowise,JS 和 TS 可用 Madge 和 dependency-cruiser;要手绘系统图,用 Structurizr。

解析的、推断的,还是手绘的?

图有三种,回答的问题不同。

类型例子优点局限
从代码解析repowise、Madge、dependency-cruiser每条边真实存在;随变更重建大仓库需要分组才看得清
模型推断GitDiagram即时、易读只看到部分代码,边可能遗漏或虚构
手绘Structurizr表达设计意图没人更新就会过时

Scroll the table sideways to see every column.

你打算据此行动的边,请对照解析出来的图确认。

如何选择

  • 单个 JS 或 TS 仓库,关注循环依赖和分层规则: dependency-cruiser,快速看一眼用 Madge。
  • 团队的架构文档: Structurizr。
  • 想用付费厂商看热点和重构优先级: CodeScene。
  • 第一次看陌生仓库: GitDiagram,然后核实。
  • 多语言、保持最新的图、历史与智能体访问: repowise。可以看看git 智能和代码健康度如何叠加在图上,或对比 FastAPI 代码健康度视图与归属地图。

延伸阅读:Monorepo 依赖图工具和我们如何为任意代码库构建依赖图。

在你自己的仓库上试试

bash
pip install repowise
repowise init        # 构建图,不需要 API key
repowise serve       # Graph、Architecture、Coupling、Blast radius 视图

也可以在首页粘贴公开仓库链接,无需账号即可打开它的地图。

常见问题

大型仓库最好的代码可视化工具是什么?
取决于你的问题。想要一个同时包含解析依赖图、架构视图、git 历史和健康度的工具,用 repowise。手工维护的架构图用 Structurizr,JavaScript 导入图和循环依赖用 Madge 或 dependency-cruiser。
什么是代码库可视化工具?
它把仓库画成图:文件或模块是节点,导入或调用是边,通常按目录分组。好用的工具由代码生成并随变更重建,所以边是可信的。
CodeSee 没了,有替代品吗?
有。GitKraken 在 2024 年收购了 CodeSee,它不再单独销售。repowise 提供文件关系的实时地图,Madge 和 dependency-cruiser 覆盖 JS 和 TS,Structurizr 覆盖手绘系统图。
JavaScript 最好的依赖图工具是什么?
Madge 是快速生成模块图和检测循环依赖的好默认选择。需要规则、多种输出格式和 CI 报告时,dependency-cruiser 更强。
LLM 生成的架构图准确吗?
通常接近,但不完整。GitDiagram 根据 README、目录树和部分源码生成图,可能遗漏它没看到的代码。你打算据此行动的边,请对照由每条导入解析出的图核实。
怎么免费可视化一个代码库?
在本地运行 repowise init 和 repowise serve 得到解析出的图;JS 和 TS 可用 Madge 或 dependency-cruiser;公开仓库可用 GitDiagram。截至 2026 年 10 月,这些都免费。

索引你的仓库,免费