go mod graph 命令可查看 Go 项目依赖关系,输出格式为“依赖源 -> 依赖目标”,结合 dot 工具可生成可视化依赖图,配合 grep 和 awk 能筛选特定依赖或反向查找引用,常用于排查版本冲突、识别冗余依赖、理解项目结构及安全审计。

在 Go 项目中,go mod graph 是一个非常实用的命令,可以帮助你查看模块之间的依赖关系。它会输出当前模块及其所有依赖项的有向图,以文本形式展示包与包之间的引用关系。
基本用法
进入你的 Go 模块项目根目录(即包含 go.mod 文件的目录),运行以下命令:
go mod graph执行后,终端会输出类似如下的内容:
github.com/user/project rsc.io/sampler@v1.3.1rsc.io/sampler@v1.3.1 golang.org/x/text@v0.3.0
rsc.io/sampler@v1.3.1 rsc.io/quote/v3@v3.1.0
每一行表示一个依赖关系,格式为:
立即学习“go语言免费学习笔记(深入)”;
依赖源 -> 依赖目标比如 rsc.io/sampler@v1.3.1 golang.org/x/text@v0.3.0 表示 sampler 模块依赖 text 模块的 v0.3.0 版本。
结合工具分析依赖
原始输出是扁平的文本,不太直观。你可以将结果导出并配合其他工具生成可视化图形。
例如,使用 Unix 管道配合 awk、dot(Graphviz)等工具生成图片:
go mod graph | dot -Tpng -o deps.png前提是你安装了 Graphviz 工具。如果没有,可以先通过系统包管理器安装:
- macOS: brew install graphviz
- Ubuntu: sudo apt-get install graphviz
- Windows: 使用 Chocolatey 或从官网下载安装
过滤和分析特定依赖
如果项目依赖较多,可以结合 grep 进行筛选:
go mod graph | grep 'golang.org/x/text'这能帮你找到哪些模块依赖了 text 包。
也可以反向查找某个模块被谁引用:
go mod graph | awk '$2 ~ /module-name/ {print $1}'常见用途
- 排查版本冲突:不同路径引入同一模块的不同版本
- 识别冗余或间接依赖:看是否引入了不必要的大模块
- 理解项目结构:快速掌握大型项目的依赖拓扑
- 审计安全漏洞:结合 CVE 数据库检查是否有问题版本
基本上就这些。go mod graph 虽然输出简单,但配合 shell 工具后能力很强,适合用于自动化脚本或 CI 中做依赖分析。不复杂但容易忽略。










