Go模块依赖图生成全攻略

想要清晰了解你的 Golang 项目依赖关系吗？本文为你详细解读 `go mod graph` 命令的使用技巧，助你轻松生成并可视化 Go 模块依赖图。首先，我们将学习如何通过 `go mod graph` 命令获取文本格式的依赖列表。接着，我们将介绍如何结合强大的 Graphviz 工具，将依赖关系转换为 DOT 格式，并渲染成直观的 PNG 图片，实现依赖关系的可视化分析。此外，我们还会推荐 `modgraphviz` 和 `depviz` 等第三方工具，它们能简化流程，一键生成精美的图形化依赖图。最后，我们将分享一些优化技巧，例如过滤 `indirect` 依赖、限制依赖深度、以及筛选特定模块，从而提升依赖图的可读性，让你快速掌握项目依赖结构，优化项目管理。

要查看 Golang 项目的模块依赖及其关系，可使用 go mod graph 命令生成依赖图，1. 在项目根目录运行 go mod graph 可查看文本格式的依赖列表；2. 结合 Graphviz 工具可将依赖转换为 DOT 格式并渲染成 PNG 图片，便于可视化分析；3. 使用第三方工具如 modgraphviz 或 depviz 可简化流程，一键生成图形化依赖图；4. 通过过滤 indirect 依赖、限制深度或筛选特定模块等优化手段，可提升依赖图的可读性。

如果你想知道当前 Golang 项目依赖了哪些模块、版本，以及这些模块之间的关系，可以使用 go mod graph 命令来生成依赖图。虽然它本身只是输出文本格式的依赖关系，但结合一些可视化工具后，就能更直观地看到整个项目的依赖结构。

基本命令：用 go mod graph 查看依赖关系

在项目根目录下运行以下命令：

go mod graph

这个命令会输出一个模块之间的依赖关系列表，每一行表示一个模块对另一个模块的依赖。例如：

golang.org/x/tools@v0.1.0 golang.org/x/xerrors@v0.0.0-20200804184101-5ec99f83aff2
github.com/stretchr/testify@v1.7.0 github.com/davecgh/go-spew@v1.1.1

这种格式对于人眼来说不太友好，所以我们可以借助一些图形化工具来将这些数据可视化。

使用 graphviz 可视化依赖图

一种常见的做法是将 go mod graph 的结果转换为 Graphviz 能识别的 DOT 格式，然后用 Graphviz 渲染成图片。

步骤如下：

• 安装 Graphviz（macOS）：

  brew install graphviz

• 生成 DOT 文件：

  go mod graph | grep -v "indirect" | dot -Tdot > deps.dot

  这里 grep -v "indirect" 是过滤掉间接依赖，让图看起来不那么复杂。

• 生成 PNG 图片：

  dot -Tpng deps.dot > deps.png

打开 deps.png 就可以看到当前项目的依赖关系图了。

注意：如果依赖太多导致图太乱，可以尝试加上 grep 来筛选特定模块，或者使用其他工具进一步处理。

用第三方工具简化流程

如果你不想手动处理 DOT 文件，也有一些现成的工具可以帮助你一键生成可视化的依赖图。

推荐两个工具：

• modgraphviz：它可以将 go mod graph 直接转成 DOT 格式，使用起来比原生命令更方便。

  安装方式：

  go install github.com/hexops/modgraphviz@latest

  使用方法：

  go mod graph | modgraphviz | dot -Tpng > deps.png

• depviz：支持在线生成依赖图。你可以把 go mod graph 的输出复制进去，自动生成图形。

这些工具能省去不少手动处理步骤，特别是当你需要经常查看依赖结构时。

优化依赖图的显示效果

即使有了图像，也可能会因为模块太多而显得混乱。这时候可以做一些简单的优化：

• 去掉 indirect 依赖：

  go mod graph | grep -v "indirect"

• 只看某个模块的依赖链：

  go mod graph | grep "your-module-name"

• 限制深度：

  如果你知道只需要看一级或两级依赖，可以在生成 DOT 文件时做适当裁剪。

这些小技巧能让你更容易看清关键依赖路径，避免被庞大的依赖网淹没。

基本上就这些。

好了，本文到此结束，带大家了解了《Go模块依赖图生成全攻略》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！