go mod tidy 是基于模块图的依赖收敛工具，仅保留导入图中可达的模块并补全缺失依赖，但会保留 test 文件、间接引用、embed/generate/cgo 相关及 replace/exclude 干预的依赖。
Go 的 go mod tidy 本身就是一个自动化清理无用依赖的机制——它会删除 go.mod 中未被当前模块直接或间接导入的依赖，同时补全缺失的依赖。关键在于理解它的行为边界和配合使用的注意事项。
go mod tidy 的核心逻辑
它不是“扫描代码后删掉没 import 的包”，而是基于模块图（module graph）做依赖收敛：
- 读取所有
.go文件中的import语句，构建当前模块的导入图 - 递归解析每个导入路径所属的模块（包括主模块、间接依赖、test-only 依赖等）
- 只保留导入图中实际可达的模块版本，移除其他冗余条目
- 自动添加
require条目以满足构建和测试所需（如testing相关间接依赖）
哪些依赖不会被 tidy 清理？
以下情况即使没在源码中显式 import，go mod tidy 也会保留：
-
test 文件中 import 的包（如
xxx_test.go里的github.com/stretchr/testify/assert） -
被其他依赖间接引用的模块（即出现在
go.sum中且被某个 require 依赖链引用） - 使用了 //go:embed、//go:generate 或 cgo 的模块（需手动确认是否仍需要）
- 被 replace 或 exclude 显式干预的模块（tidy 尊重这些指令，但不会帮你判断是否合理）
安全清理的推荐操作流程
避免误删或遗漏，建议按顺序执行：
立即学习“go语言免费学习笔记（深入）”；
- 运行
go mod tidy -v查看详细变化（加-v可见增删日志） - 检查输出中是否意外移除了你预期要保留的模块（比如某些工具类库仅在 CI 脚本里用）
- 运行
go build ./...和go test ./...确保功能正常 - 若项目含生成代码（如 protobuf），先重新生成再 tidy，否则可能误删生成器依赖
- 提交前对比
go.mod和go.sum变更，重点关注require块的删减
进阶：识别“看似无用”实则必要的依赖
有些包不被直接 import，但影响构建或运行时行为：
-
golang.org/x/sys：常被标准库隐式依赖（如os/exec在不同平台调用） -
github.com/golang/protobuf或google.golang.org/protobuf：proto 编译后生成代码的运行时依赖 - 含
init()函数的包（如数据库驱动注册）：只要被任意 import 链触发就会生效，tidy 不会删
这类依赖往往通过间接路径存在，go mod graph | grep xxx 可追溯来源。
基本上就这些。go mod tidy 本身足够可靠，真正需要人工判断的是“这个依赖到底算不算业务上无用”，而不是“能不能删”。
