在Golang的项目开发中，模块依赖管理是核心工作之一，了解项目的模块依赖图能够帮助我们快速定位依赖版本冲突、冗余依赖等问题，提升项目的可维护性。Golang自带的go mod相关命令就提供了查看模块依赖图的能力，不需要额外安装第三方工具。
使用go mod graph命令查看基础依赖图
go mod graph是Golang官方提供的用于输出模块依赖图的命令，它会读取项目根目录下的go.mod和go.sum文件，输出所有模块之间的直接依赖和间接依赖关系。
在项目根目录下执行以下命令即可查看依赖图：
# 进入项目根目录 cd your_project_path # 执行查看依赖图命令 go mod graph
命令的输出结果每行代表一条依赖关系，格式为当前模块 依赖模块@版本号，例如：
github.com/your_project 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/chenzhuoyu/base64x@v0.0.0-20221115062448-fe3a3abad311
对依赖图输出进行过滤和整理
go mod graph的输出内容通常比较多，直接查看不够直观，我们可以结合其他命令对输出结果进行过滤，只查看我们关心的依赖信息。
查看指定模块的依赖
如果我们只想查看某个特定模块的所有依赖，可以使用grep命令进行过滤：
# 查看gin框架的所有依赖 go mod graph | grep gin-gonic/gin
查看依赖某个模块的其他模块
如果需要知道哪些模块依赖了某个特定的包，也可以反向过滤：
# 查看哪些模块依赖了sonic包 go mod graph | grep sonic
使用可视化工具展示依赖图
如果觉得文本形式的依赖图不够直观，我们可以将go mod graph的输出转换为可视化格式，比如使用graphviz工具生成依赖关系图。
首先安装graphviz工具，不同系统的安装命令如下：
- Ubuntu/Debian系统：
sudo apt-get install graphviz - MacOS系统：
brew install graphviz - Windows系统：从graphviz官网下载安装包安装即可
安装完成后，执行以下命令生成依赖图：
# 将依赖图转换为dot格式，再生成png图片 go mod graph | dot -Tpng -o dependency_graph.png
生成的dependency_graph.png文件就是可视化的模块依赖图，节点的连线代表依赖关系，能够更清晰地看到模块之间的层级结构。
依赖图相关问题排查
在查看依赖图时，可能会遇到一些常见的问题，比如同一个模块出现多个版本，这通常是依赖冲突导致的。我们可以通过以下方式排查：
首先查看go.mod文件中是否有显式的版本替换规则，replace指令会修改依赖的版本指向。如果没有replace规则，再查看是否是不同直接依赖引入了同一个模块的不同版本，go mod会默认选择语义化版本更高的版本，如果出现异常可以在go.mod中显式指定需要的版本。
另外，我们可以使用go mod why 模块名@版本号命令查看某个依赖被引入的原因，帮助定位冗余依赖的来源。
实际示例演示
假设我们有一个简单的Golang Web项目，go.mod内容如下：
module ippipp.com/web_project
go 1.20
require (
github.com/gin-gonic/gin v1.9.1
github.com/go-redis/redis/v8 v8.11.5
)
执行go mod graph命令后，部分输出如下：
ippipp.com/web_project github.com/gin-gonic/gin@v1.9.1 ippipp.com/web_project github.com/go-redis/redis/v8@v8.11.5 github.com/gin-gonic/gin@v1.9.1 github.com/gin-contrib/sse@v0.1.0 github.com/gin-gonic/gin@v1.9.1 github.com/go-playground/validator/v10@v10.14.0 github.com/go-redis/redis/v8@v8.11.5 github.com/cespare/xxhash/v2@v2.1.2
从这个输出我们可以清晰看到项目直接依赖了gin和redis两个模块，同时这两个模块又分别依赖了其他的子模块，所有依赖关系都可以从输出中逐层追溯。
Golang模块依赖图go_mod_graph依赖分析go_mod修改时间：2026-06-19 01:09:35