go mod graph 可查看 Go 项目依赖关系，输出格式为“被依赖模块 -> 依赖模块”，支持 grep 过滤、版本冲突检测及通过 graphviz 可视化，常用于排查依赖问题。
在 Go 语言项目中，随着依赖增多，了解模块之间的依赖关系变得非常重要。Go 提供了 go mod graph 命令来帮助开发者查看当前模块的依赖图谱。这个命令可以输出所有直接和间接依赖的关系，便于排查冲突、重复依赖或版本不一致的问题。
理解 go mod graph 输出格式
go mod graph 的输出是文本形式的有向图，每一行表示一个依赖关系：
被依赖模块 -> 依赖模块例如：
github.com/user/project golang.org/x/text@v0.3.7 golang.org/x/text@v0.3.7 golang.org/x/tools@v0.1.0
这表示 project 依赖 text v0.3.7，而 text 又依赖 tools v0.1.0。
立即学习“go语言免费学习笔记（深入）”；
常用使用方式与场景
进入你的 Go 模块根目录（包含 go.mod 文件），执行以下命令：
go mod graph你可以结合其他命令工具进一步分析输出结果：
-
查看某个特定依赖被谁引用：
go mod graph | grep "some-module" -
查找指定模块的所有上游依赖：
使用脚本或工具从图中反向追踪哪些模块引用了它。 -
检测重复依赖的不同版本：
go mod graph | grep "module-name" 可能显示多个版本，说明存在版本冲突。 -
导出为可视化图形（需配合 graphviz）：
将输出转换成.dot文件并生成图像：go mod graph | dot -Tpng -o dep_graph.png
（前提是你已经安装 graphviz 工具）
实际排查案例：解决版本冲突
假设你发现项目中 golang.org/x/crypto 出现了两个版本，可以通过以下步骤定位问题：
- 运行：go mod graph | grep "golang.org/x/crypto"，观察哪几行提到了该模块。
- 找到引用这些版本的上级模块，比如输出中有：
github.com/a/b v1.0.0 -> golang.org/x/crypto@v0.0.1 github.com/c/d v2.1.0 -> golang.org/x/crypto@v0.0.2
- 说明 a/b 和 c/d 分别依赖不同版本的 crypto，Go 构建时会自动选择兼容的最高版本。
- 如需强制统一版本，可在 go.mod 中添加 replace 或 require 指令。
基本上就这些。go mod graph 不复杂但容易忽略，掌握它可以更清晰地理解项目的依赖结构，尤其在维护大型项目或多团队协作时非常有用。
