如何在Go中查看模块依赖树_Go Module依赖树查看方法

go list 和 go mod graph 是 Go 依赖分析的核心命令：前者可查直接依赖、完整依赖树及版本信息，后者配合 Graphviz 能生成可视化依赖图。

直接用 go list 命令就能查看模块依赖树，不需要额外工具，Go 自带功能足够清晰实用。

查看当前模块的直接依赖

运行以下命令，列出项目直接引入的模块（即 go.mod 中的 require 条目）：

go list -m -f '{{.Path}} {{.Version}}' all | grep -v '^\.'

如果只想看顶层依赖（排除间接依赖），更推荐：

go list -m -direct

查看完整的依赖树结构

使用 -deps 参数展开所有嵌套依赖，配合格式化输出可看清层级关系：

go list -f '{{.Path}}: {{.DependsOn}}' -deps .

但这个输出较原始。更直观的方式是用缩进模拟树形，例如：

go list -f '{{.Path}}{{with .DependsOn}} => {{join . " => "}}{{end}}' -deps . | sed 's/=> /> /g'

或者用第三方辅助（非必需）：安装 goda 或 gomodtree 可获得彩色、缩进更规范的树状图。

排查重复或冲突的依赖版本

当遇到版本不一致或 go mod tidy 后行为异常时，重点检查哪些模块拉入了同一依赖的不同版本：

• 运行 go list -m -versions [module-name] 查看某模块所有可用版本
• 用 go list -u -m all 列出可升级的模块（含当前和最新版）
• 结合 go mod graph | grep [module] 快速定位谁引入了特定模块

生成依赖图谱（可视化可选）

若需图形化展示，可导出为 dot 格式再用 Graphviz 渲染：

go mod graph | sed 's/ / -> /' | sed 's/$/;/' | sed '1i digraph G {' | sed '$a }' > deps.dot

然后执行：
dot -Tpng deps.dot -o deps.png
就能得到一张清晰的依赖关系图。

基本上就这些。核心是 go list 和 go mod graph，熟练掌握它们足以应对绝大多数依赖分析场景。