最直接安全的方式是运行 go mod tidy，它基于整个 module 源码（含测试文件）静态分析依赖，自动移除未引用模块、补全缺失依赖并同步 go.sum。
在 Go 项目中，删除未使用的包最直接、安全的方式就是运行 go mod tidy。它会自动分析代码依赖关系，移除 go.mod 和 go.sum 中不再被引用的模块，同时补全当前缺失但实际被引用的依赖。
go mod tidy 的作用机制
该命令不是简单地“扫描 import 语句”，而是基于整个 module 的源码（包括测试文件）做静态分析，识别出真正被构建和测试所依赖的模块。它会：
- 从所有
.go文件中提取 import 路径，确认哪些模块被实际使用 - 删除
go.mod中存在但未被任何 import 引用的require条目 - 添加当前缺失但代码中已 import 的模块及其版本
- 同步更新
go.sum，确保校验和完整准确
执行前建议检查的事项
为避免误删或遗漏，运行前可先确认以下几点：
- 确保当前工作目录是 module 根目录（含
go.mod文件） - 检查是否包含未提交的代码变更，尤其是新增了 import 但还没保存的文件
- 留意是否有条件编译（如
//go:build ignore或平台特定文件），这些可能影响依赖判断 - 如果项目包含多个子 module（如 vendor 下或嵌套 module），
go mod tidy默认只处理当前 module，需进入对应目录分别执行
常见问题与应对方式
有时 go mod tidy 没有按预期删除某些包，原因可能包括：
立即学习“go语言免费学习笔记（深入）”；
-
间接依赖残留：某个已删除的包仍被其他依赖项引用，此时它会保留在
go.mod中作为 transitive dependency，属于正常行为 -
测试文件中引用：即使主逻辑没用到，但
xxx_test.go中 import 了该包，也会被保留 -
replace 或 exclude 干扰：若
go.mod中有replace或exclude语句，可能影响 tidy 的判断逻辑，可临时注释后重试 -
未启用 Go Modules：确认环境变量
GO111MODULE=on（或不设为off），否则命令可能降级为 GOPATH 模式，不生效
辅助清理技巧
若想进一步确认哪些包是“疑似未使用”的，可配合以下操作：
- 用
go list -deps -f '{{if not .Standard}}{{.ImportPath}}{{end}}' ./...查看全部非标准库依赖路径 - 对比
go mod graph输出，搜索某包是否仅出现在依赖链末端且无 direct import - 对单个包尝试
go get -u package@none（Go 1.21+ 支持），可强制从go.mod中移除（慎用，不推荐替代 tidy）
