本页目录
最好的代码可视化工具取决于你需要哪种图。 想把 C4 架构图当代码维护,用 Structurizr;想看 JavaScript 和 TypeScript 的导入图与循环依赖,用 Madge 或 dependency-cruiser;想看热点地图,用 CodeScene;想快速给公开仓库画个草图,用 GitDiagram;想要一张由代码解析而来、覆盖 28 种语言、并把归属和 git 历史放在同一张图上的地图,用 repowise。
| 工具 | 画什么 | 图从哪来 | 价格(2026 年 10 月) |
|---|---|---|---|
| repowise | 依赖图、架构图、耦合、影响范围、归属、热点 | 解析代码并挖掘 git 历史,不需要模型 | 开源可自托管;托管版免费支持两个公开仓库 |
| Structurizr | C4 系统、容器、组件、部署视图 | 你用 DSL 写模型 | 命令行免费;服务端需要许可 |
| CodeScene | 热点、代码健康度、团队与知识分布 | 分析代码和 git 历史 | 每位活跃作者每月 18 欧元起 |
| GitDiagram | 一张交互式 Mermaid 架构图 | LLM 读取目录树、README 和部分源码 | 免费,MIT 许可 |
| Madge | JS 模块图、循环导入 | 解析导入语句 | 免费开源 |
| dependency-cruiser | JS 和 TS 依赖图,加 CI 规则检查 | 按你的规则解析导入 | 免费,MIT 许可 |
| Sourcegraph | 跨仓库搜索与导航,含 Insights | 为代码建索引 | 企业版,约每年 1.6 万美元起 |
Scroll the table sideways to see every column.
我们如何评估
画出节点和边是最容易的部分。我们看四点:
- 是否保持最新。 图是从仓库重新生成的,还是靠人重画?手绘图只在画完那天是准的。
- 解析还是推断。 每条边来自真实存在的代码,还是模型对部分代码的理解?做决定需要前者。
- 粒度。 能否在仓库、包、文件、符号之间切换?
- 能帮你做什么。 循环依赖、归属、风险和历史,能把一张图变成一个决定。
各个工具画什么?
repowise
repowise 在 repowise init 时构建文件和符号两层的图,不调用模型,不联网。每条边都记录产生它的策略和置信度,所以猜测出来的边不会被当成确定的边展示(见图文档)。repowise update 让它保持最新。

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

同一张图也通过 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 依赖图工具和我们如何为任意代码库构建依赖图。
在你自己的仓库上试试
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 月,这些都免费。


