go mod tidy命令可自动清理未使用模块并修复依赖，建议每次删代码后执行；通过go list和go mod why预览无用模块；CI中添加go mod tidy -check确保依赖整洁。
在Golang项目中，随着开发推进，一些依赖模块可能不再被使用，但仍然保留在go.mod文件中。这些未使用的模块不仅会增加构建时间，还可能带来安全风险或版本冲突。Go语言从1.15版本开始引入了自动检测和清理未使用模块的功能，下面介绍几种有效的清理方法。
启用自动清理未使用模块（Go 1.15+）
Go工具链支持自动识别并标记未使用的依赖。只需运行以下命令：
go mod tidy
该命令会：
- 添加缺失的依赖项到
go.mod - 移除未被引用的模块
- 确保
go.sum与当前依赖一致
这是最常用也是推荐的清理方式。建议每次删除功能代码后都执行一次go mod tidy。
立即学习“go语言免费学习笔记（深入）”；
查看哪些模块未被使用
如果你希望先确认哪些模块将被移除，可以使用以下命令预览：
go list -u -m all
结合grep可以筛选出未使用的模块：
go mod why -m [module-name]
如果输出包含no required module，说明该项目并未被直接或间接导入，属于可清理项。
强制排除特定模块（谨慎使用）
在极少数情况下，某些模块因历史原因残留且无法通过tidy清除，可以手动编辑go.mod文件，在对应模块后添加// indirect注释或直接删除整行。例如：
require (
github.com/some/unused/module v1.0.0 // 删除此行或改为indirect
)
修改后务必再次运行go mod tidy以修复一致性。
持续集成中加入模块检查
为防止未使用模块再次积累，可在CI流程中加入校验步骤：
go mod tidy -check if [ $? -ne 0 ]; then echo "存在未整理的依赖，请运行 go mod tidy" exit 1 fi
这样能确保团队协作时依赖关系始终保持整洁。
基本上就这些。合理使用go mod tidy，定期检查依赖状态，就能有效维护go.mod的干净与健康。不复杂但容易忽略。
