go mod graph 以文本形式输出模块依赖拓扑图,每行表示“主模块→依赖模块”的有向边,支持 grep 筛选、版本冲突分析及导出为 DOT 格式供 Graphviz 可视化。

使用 go mod graph 可以快速输出当前模块的依赖关系图,它以“主模块 → 依赖模块”的有向边形式列出所有直接和间接依赖。这不是图形化工具,而是纯文本拓扑结构,适合配合其他命令或脚本进一步分析。
基础用法:查看完整依赖列表
在项目根目录下运行:
go mod graph
输出形如:
立即学习“go语言免费学习笔记(深入)”;
myproject.com v0.1.0 github.com/sirupsen/logrus v1.9.0
github.com/sirupsen/logrus v1.9.0 golang.org/x/sys v0.5.0
myproject.com v0.1.0 golang.org/x/net v0.14.0
每行代表一个依赖边(A → B),即 A 显式或隐式依赖 B。注意:重复出现的模块版本表示多个路径引入了同一依赖。
筛选特定模块的依赖路径
结合 grep 快速定位某模块的来源:
go mod graph | grep logrus
若想看谁依赖了 golang.org/x/crypto,可反向匹配:
go mod graph | grep "golang.org/x/crypto" | cut -d' ' -f1 | sort -u
这会列出所有直接或间接引入该模块的上游模块。
识别重复或冲突的依赖版本
当多个版本共存时,go list -m all 显示最终选中的版本,而 go mod graph 能暴露“被替换前”的原始引用关系。例如:
- 若输出中同时出现
A v1.2.0 github.com/example/lib v0.5.0和B v2.1.0 github.com/example/lib v0.6.0,说明不同模块拉取了不同版本 - 此时可运行
go mod graph | grep "github.com/example/lib"查看哪些模块引入了哪个版本 - 再用
go mod why github.com/example/lib追踪某版本被选用的具体原因
导出为可视化格式(需额外处理)
go mod graph 输出符合 DOT 语言 的边定义,稍作整理即可用 Graphviz 渲染:
echo "digraph deps {" > deps.dot
go mod graph | sed 's/ / -> /g' >> deps.dot
echo "}" >> deps.dot
dot -Tpng deps.dot -o deps.png
注意:实际使用前建议先用 head -n 100 或 grep 过滤,避免生成过大的图影响可读性;也可用 go mod graph | wc -l 预估依赖规模。










