Golang如何使用go mod graph查看依赖关系

在Golang的模块化管理体系中，依赖关系的梳理是项目维护的核心工作之一，go mod graph作为官方内置的依赖查看命令，能够快速输出当前项目的完整依赖拓扑信息，是开发者分析依赖问题的基础工具。

go mod graph基础用法

go mod graph命令不需要额外安装，只要项目已经初始化go.mod文件，就可以直接在项目根目录执行。执行后会输出所有模块之间的依赖关系，每一行代表一条依赖边，格式为依赖方@版本 被依赖方@版本。

基础执行示例如下：

# 进入项目根目录
cd /path/to/your/golang/project
# 执行go mod graph命令
go mod graph

输出结果示例：

github.com/your/project@v0.1.0 github.com/gin-gonic/gin@v1.9.1
github.com/gin-gonic/gin@v1.9.1 github.com/bytedance/sonic@v1.9.1
github.com/gin-gonic/gin@v1.9.1 github.com/gin-contrib/sse@v0.1.0
github.com/bytedance/sonic@v1.9.1 github.com/chenzhuoyu/base64x@v0.0.0-20221115062448-fe3a3abad311

go mod graph输出解析

输出的每一行都表示左边模块依赖右边模块，版本号会跟随模块路径一起展示，方便区分同一模块的不同版本。如果项目存在间接依赖，也会在输出中完整体现，比如gin依赖sonic，sonic又依赖base64x，这些层级关系都会逐行展示。

如果需要筛选特定模块的依赖关系，可以结合grep命令使用，示例如下：

# 查看gin-gonic/gin的所有依赖
go mod graph | grep "github.com/gin-gonic/gin@"
# 查看哪些模块依赖了sonic
go mod graph | grep "github.com/bytedance/sonic@"

其他Golang依赖关系分析方法

go mod why

go mod why用于查看为什么需要某个依赖，执行后会输出依赖的引入路径，帮助开发者判断依赖是否为冗余依赖。用法如下：

# 查看为什么需要github.com/bytedance/sonic模块
go mod why github.com/bytedance/sonic

go mod tidy

go mod tidy会移除go.mod和go.sum中无用的依赖，同时添加缺失的依赖，执行后可以结合go mod graph查看精简后的依赖关系，避免冗余依赖干扰分析。

# 清理无用依赖
go mod tidy
# 再次查看依赖关系
go mod graph

可视化工具

如果需要更直观的依赖拓扑图，可以使用第三方工具将go mod graph的输出转换为可视化图形，比如使用modgraph工具，安装后执行即可生成依赖关系图：

# 安装modgraph工具
go install github.com/paulvollmer/modgraph@latest
# 生成依赖关系图
modgraph -format dot | dot -Tpng -o dependency.png

依赖关系分析注意事项

分析依赖时需要注意版本冲突问题，如果同一个模块出现多个版本，go mod graph会展示所有版本及对应的依赖方，此时需要结合go mod why确认是否需要多版本共存，或者通过修改go.mod中的版本约束统一依赖版本。

另外，间接依赖通常不会直接写在go.mod中，而是通过其他依赖引入，分析时不能忽略间接依赖的层级关系，避免遗漏深层依赖的问题。

go_mod_graphGolang依赖关系分析修改时间：2026-06-18 19:39:44