go mod graph 命令可输出 Go 项目依赖关系，每行以“→”表示模块间的有向依赖，如 moduleA → moduleB 表示 A 依赖 B，结合 sort、grep 或 Graphviz 可排序、过滤或可视化依赖树，适用于排查版本冲突、清理冗余依赖、审计第三方库及理解项目结构。
在 Go 项目中，依赖管理主要通过 Go Modules 实现。当你需要了解项目中各个模块之间的依赖关系时，go mod graph 是一个非常实用的命令。它能输出项目的完整依赖树结构，帮助你排查版本冲突、冗余依赖或间接依赖问题。
go mod graph 命令基本用法
在项目根目录（包含 go.mod 文件的目录）执行以下命令：
go mod graph该命令会输出一个文本格式的依赖关系列表，每一行表示一个依赖指向：
moduleA v1.0.0 → moduleB v2.1.0moduleB v2.1.0 → moduleC v0.5.0
箭头左侧是依赖方，右侧是被依赖方。这种格式称为“有向图”，可以清晰展示模块间的依赖流向。
立即学习“go语言免费学习笔记（深入）”；
理解输出内容
输出的每一行代表一个直接或间接依赖关系。例如：
golang.org/x/text v0.3.0 → golang.org/x/tools v0.6.0
说明：
- github.com/user/project 直接依赖 golang.org/x/text
- golang.org/x/text 又依赖 golang.org/x/tools，这是间接依赖
注意：输出结果不区分直接依赖和间接依赖，所有依赖关系都会列出。
结合工具分析依赖图
原始文本输出对人类不够友好，可以通过以下方式增强可读性：
- 管道到 sort 排序：便于查找特定模块 go mod graph | sort
- 过滤特定依赖：查看某个模块被谁引用 go mod graph | grep "golang.org/x/text"
- 转换为可视化图形：使用 Graphviz 等工具生成图像 go mod graph | sed 's/ / -> /' | awk '{print $1 " -> " $2 ";"}' > deps.dot
echo "digraph G {" > graph.dot
cat deps.dot >> graph.dot
echo "}" >> graph.dot
dot -Tpng graph.dot -o dependency.png
常见使用场景
这个命令特别适用于：
- 排查版本冲突：同一个模块多个版本被引入时，可通过图谱定位来源
- 清理冗余依赖：发现某些模块已被废弃但仍存在于依赖链中
- 审计第三方库：查看间接依赖是否引入了安全风险组件
- 理解项目结构：快速掌握大型项目的外部依赖构成
基本上就这些。go mod graph 虽然输出简单，但配合文本处理工具后非常强大，是 Go 模块调试的必备命令之一。不复杂但容易忽略细节，比如箭头方向代表“依赖于”，别看反了。
