go list 是 Go 工具链中用于查询包与模块元数据的命令，支持 JSON/ 文本输出，适用于脚本集成与依赖分析；可查模块信息、直接依赖、包依赖关系及潜在未使用模块。
go list 是 Go 工具 链中功能强大且常被低估的命令，专用于查询包、模块及其依赖的结构化信息。它不编译也不运行代码，只解析源码和 go.mod，输出 JSON 或文本格式的元数据，适合脚本集成、CI 分析或快速诊断依赖问题。
查看当前模块的基本信息
在项目根目录（含 go.mod）执行以下命令，可获取模块路径、主包名、Go 版本等基础字段：
go list -m –json
输出为 JSON，包含 Path（模块路径）、Version（版本号）、Dir（本地路径）、GoMod（go.mod 文件路径）等关键字段。若项目未启用模块（无 go.mod），加 -modfile 或切换到模块模式再试。
列出所有直接依赖模块
用 -m 搭配 -deps 可展开整个依赖树，但默认会包含间接依赖。要只看一级直接依赖，推荐：
立即学习“go 语言免费学习笔记（深入）”；
go list -m -f ‘{{if not .Indirect}}{{.Path}} {{.Version}}{{end}}’ all
说明：
• -m 表示操作模块而非包
• -f 使用自定义模板，.Indirect 为 true 表示该模块是间接引入（即非 go.mod 中显式 require）
• all 是特殊模式，代表当前模块及所有依赖
查询特定包的依赖关系
例如想看 net/http 在当前构建环境下实际使用的具体包路径和导入位置：
go list -f ‘{{.ImportPath}} {{.Deps}}’ net/http
更实用的是结合 -json 输出完整依赖列表：
go list –json -deps net/http | jq ‘.ImportPath, .Deps’
注意：这里 net/http 是 标准库 包，无需下载；若查第三方包（如 github.com/gin-gonic/gin），需确保已 go mod download 或至少出现在 go.sum 中，否则会报错“no matching versions”。
检查未使用的依赖（潜在的清理目标）
Go 1.18+ 支持 -u 标志配合 go list 找出 go.mod 中存在但未被任何包 import 的模块：
go list -m -u all
输出中带 Update 字段的表示有新版本；而完全没被引用的模块不会出现在结果里——真正“未使用”的模块需配合 go mod graph 或第三方工具（如 gostatus）交叉验证。简单判断法：
• 运行 go list -f '{{.ImportPath}}' ./…… 获取所有本地包的 import 路径
• 对比 go list -m -f '{{.Path}}' all 的输出，取差集即为疑似冗余模块
