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 清掉：
睿拓企业网站系统1.2
下载
睿拓智能网站系统-睿拓企业网站系统1.2免费版软件大小:6M运行环境：asp+access本版本是永州睿拓信息企业网站管理系统包括了企业网站常用的各种功能，带完整的后台管理系统，本程序无任何功能限制下载即可使用，具体功能如下。1.网站首页2.会员注册3.新闻文章模块4.产品图片展示模块5.人才招聘模块6.在线留言模块7.问卷调查模块8.联系我们模块9.在线QQ客服系统10.网站流量统计系统11.后
立即学习“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 ./... 和目标平台构建是否仍通过。
