go mod tidy 会删除未被任何 import 引用、且非间接依赖的模块；包括测试文件和条件编译中未生效的依赖，但需注意隐式导入（如 _ “module”）无法被感知。
go mod tidy 会删掉哪些依赖
go mod tidy 的核心行为是「确保 go.mod 精确反映当前代码实际 import 的模块」。它不会盲目删除，而是先扫描所有 .go 文件中的 import 语句，再比对 go.mod 中的 require 条目：没被任何 import 引用、且不是其他已引用模块的间接依赖（// indirect）的条目，才会被移除。
常见误判场景：
- 代码里用
_ "some/module"隐式加载（比如驱动注册），但go mod tidy无法感知这种副作用，可能误删 - 测试文件（
*_test.go）里 import 的模块，如果没在主代码中使用，tidy默认也会删——除非你加了-t参数 - 跨平台构建时，
// +build windows这类条件编译块里的 import，若当前构建环境不满足条件，tidy可能漏掉或误删
清理前必须检查的三个地方
直接跑 go mod tidy 很快，但删错依赖会导致编译失败或运行时 panic。务必提前确认：
- 查看
go.mod中带// indirect标记的模块——它们是传递依赖，不能手动删，得靠tidy或上游模块更新来调整 - 运行
go list -m all | grep 'your-unwanted-module'，确认该模块是否出现在完整依赖图里，而不仅是go.mod中 - 检查
go.sum是否残留对应校验和；tidy会自动清理，但如果手动删了go.mod行却没运行tidy，go.sum会不一致，后续go build可能报checksum mismatch
强制保留某模块的两种可靠方式
有些模块虽无直接 import，但必须存在（如插件机制、代码生成 工具 依赖）。避免被 tidy 清掉：
立即学习“go 语言免费学习笔记（深入）”；
- 在任意一个
.go文件里加一行：import _ "github.com/xxx/yyy"（下划线导入），tidy就会认为它被使用 - 用
replace指向一个空模块（仅调试用）：replace github.com/xxx/yyy => ./internal/empty，并在
./internal/empty/go.mod中声明模块名——这会让tidy保留该行，但不拉取真实代码
CI/CD 中安全执行 tidy 的建议
自动化流程里跑 go mod tidy 容易因环境差异出问题：
- 始终搭配
go mod tidy -v输出变更详情，把 stdout 当日志存档，便于回溯删了什么 - 禁止在 CI 中用
go mod tidy -w直接写入；应先本地运行，提交go.mod和go.sum变更，CI 只做验证：go mod tidy -v && git diff --quiet go.mod go.sum - 如果项目含
cgo或需要特定GOPROXY，确保 CI 环境变量 与本地一致，否则tidy可能因拉包失败而静默跳过某些模块
最常被忽略的是测试文件和条件编译——它们让 tidy 的“是否使用”判断变得不透明，每次清理后最好手动验证 go test ./…… 和目标平台构建是否仍通过。
