go mod tidy 是清理 Go 项目冗余依赖的标准方法，它通过静态分析所有 .go 文件的 import 语句，递归计算直接和间接依赖，自动添加缺失模块、移除未引用模块，并同步更新 go.sum。
在 Go 项目中，依赖冗余通常表现为 go.mod 文件里声明了模块，但代码中并未实际导入（import）它们。这会让构建变慢、增大二进制体积，还可能引入潜在安全风险。使用 go mod tidy 是最标准、最安全的清理方式——它会自动删掉未被引用的模块，并补全当前代码真正需要的依赖。
go mod tidy 的工作原理
go mod tidy 不是简单地“删掉没用的行”，而是基于整个模块的 import 语句做静态分析：它会扫描所有 .go 文件，找出所有显式导入的包，然后递归计算这些包所依赖的模块，最终生成一个最小、一致、可复现的依赖集合。
- 只保留代码中直接或间接 import 的模块
- 自动添加缺失的依赖（比如某个第三方库内部用了
golang.org/x/net，而你没显式 import，它也会被加入） - 自动移除已删除或未被任何 import 引用的模块
- 同步更新
go.sum，确保校验和完整
执行 tidy 前的必要准备
为避免误删或遗漏，建议在运行前确认以下几点：
- 确保所有
.go文件都已保存，特别是刚删掉 import 语句的文件 - 检查是否有条件编译（如
//go:build ignore或_test.go文件），因为tidy默认会处理所有构建标签启用的代码 - 若项目含多个 module（如子目录下有独立
go.mod），需分别进入对应目录执行go mod tidy - 建议先提交当前变更，或备份
go.mod，便于回溯
常用 tidy 操作与注意事项
基础命令很简单：
立即学习“go语言免费学习笔记（深入）”；
go mod tidy
但根据场景，还可配合其他参数使用：
-
go mod tidy -v：显示详细过程，看到哪些模块被添加/删除，适合调试 -
go mod tidy -compat=1.21：指定兼容的 Go 版本（影响某些隐式依赖行为） - 如果想清理
replace中已失效的重定向，tidy也会一并修正（前提是原模块已不再被引用） - 注意：
go mod tidy不会删除require中标记为// indirect的模块——只要它们仍是传递依赖，就会保留；只有彻底断开引用链后才会被移除
验证清理是否生效
运行完 go mod tidy 后，可通过以下方式确认效果：
- 对比
go mod graph | wc -l行数变化（依赖图边数减少说明精简了） - 执行
go list -m all | wc -l查看当前解析出的模块总数 - 手动检查
go.mod，确认无明显无关项（如旧版本工具类库、已废弃 SDK） - 运行
go build ./...和go test ./...确保功能未受影响
