go mod graph 输出的是模块级有向边列表，每行表示“a/b 依赖 c/d 的指定版本”，不体现层级、不合并节点、不区分直接/间接依赖，也不处理 replace 或 exclude。
go mod graph 输出的是边，不是树
go mod graph 本质是模块级有向边列表，每行形如 github.com/a/b github.com/c/d@v1.2.3，只表示“a/b 依赖 c/d 的这个版本”，不体现层级、不合并重复节点、不标注直接/间接。它不区分 require 和 indirect，也不处理 replace 或 exclude——这些在输出里仍显示原始路径。想靠它一眼看清“谁引入了谁”，基本不可能。
gomodtree 是目前最实用的树形依赖查看器
它把 go mod graph 的扁平关系重构成缩进树，更贴近人类直觉。安装和使用很简单：
- 安装：
go install github.com/icholy/gomodtree@latest（注意不是已归档的 loic-lopez 版本） - 运行：
gomodtree默认分析当前 module；加参数如gomodtree github.com/your/app可指定目标模块 - 它会标出
(indirect)和(replace)，但依赖本地go.sum和模块缓存——CI 环境刚拉代码没执行过go mod download，可能漏掉部分间接依赖
go mod why -m 只给一条最短路径，别当全图用
当你在 go list -m all 里看到一个陌生模块，go mod why -m example.com/pkg 会返回从主模块出发的一条最短 import 路径，例如：
main github.com/spf13/cobra github.com/spf13/pflag gopkg.in/yaml.v2
但它不保证覆盖所有引入路径。如果该模块被多个地方以不同版本引入，需手动结合 go mod graph | grep 检查；对 replace 后的本地路径（如 ./fix）也无效，得查原始模块名。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
可视化前必须清洗，否则 dot 直接报错
直接 go mod graph | dot -Tpng 必然失败，报错 Error: syntax error in line 1 near 'github.com'。原因很实在：DOT 格式要求节点名含 / 和 @ 的必须用双引号包裹，而 go mod graph 输出完全不满足。清洗至少要三步：
- 补
digraph G {开头和}结尾 - 每行加上引号：
sed 's/^\([^ ]*\) \([^ ]*\)/"\1" -> "\2"/' - 去重 + 去测试/内部包（可选）：
grep -v '/internal/test\|_test\.go\|/testdata' - 大型项目务必加
head -n 500，否则生成的 PNG 可能超百兆且无法打开
真正能跑通的最小命令链是：go mod graph | sed 's/^\([^ ]*\) \([^ ]*\)/"\1" -> "\2"/' | sort -u | head -n 500 | sed '1i digraph G {' | sed '$a }' | dot -Tpng -o deps.png。别跳过清洗——这是唯一能让 dot 不吐错的地方。
