go list -m -json 输出当前模块及其依赖的结构化JSON信息，含版本、replace、Indirect、Time、GoMod等字段，支持 -deps（递归依赖）、all（全部已知模块）等参数，适用于CI集成与依赖分析。
go list -m -json 能查到什么
它输出当前模块及其所有依赖模块的结构化信息，包括版本、替换路径、是否为主模块、校验和等。不是简单列出模块名，而是提供可编程解析的 JSON 数据，适合集成进 CI 脚本或依赖分析工具。
-
go list -m -json默认只显示主模块（即当前目录对应的 module） - 加
-deps才递归展开全部依赖树 - 加
all参数（如go list -m -json all）会包含所有已知模块，包括未被直接引用但存在于go.mod中的 indirect 模块 - 不加
-deps时，go list -m -json ./...无效 ——-m模式下不接受包路径参数
常用组合与对应场景
根据你要解决的问题选命令，不是背参数：
- 查当前模块的精确版本和 replace 状态：
go list -m -json
- 查某一个依赖模块（比如
golang.org/x/net）的详情：go list -m -json golang.org/x/net
- 生成完整依赖树用于审计（含 indirect 和 version 冲突提示）：
go list -m -json -deps
- 导出所有模块（含未使用但保留在
go.mod中的）供 diff 或去重：go list -m -json all
容易忽略的关键字段含义
输出 JSON 中几个常被跳过的字段，实际影响很大：
-
Indirect：为true表示该模块未被主模块直接 import，只是被其他依赖间接拉入 —— 删除它可能不会立刻报错，但升级上游时容易出问题 -
Replace：非空说明用了replace指令，字段里包含New（目标路径）和Version（如果指向本地路径则为空） -
Time：仅当模块来自 proxy 或 vcs 且有 tag 时存在，可用于判断是否用了带时间戳的 pseudo-version（如v0.0.0-20230101120000-abcdef123456） -
GoMod：该模块go.mod文件的绝对路径，能帮你确认是否意外加载了 vendor 下或 GOPATH 中的旧副本
配合 jq 快速提取关键信息
原始 JSON 太长，用 jq 过滤更实用。例如：
立即学习“go语言免费学习笔记（深入）”；
- 只看所有 direct 依赖（排除 indirect）：
go list -m -json -deps | jq 'select(.Indirect != true) | {Path, Version}' - 找出所有被 replace 的模块：
go list -m -json -deps | jq 'select(.Replace != null) | {Path, Replace}' - 检查是否有版本为
none的模块（通常表示本地 replace 失败或路径错误）：go list -m -json all | jq 'select(.Version == "none")'
注意：Windows 用户若没装 jq，可用 PowerShell 的 ConvertFrom-Json 替代，但性能差、嵌套深时易出错。macOS/Linux 下强烈建议配 jq。
