Go语言依赖管理实战指南（手把手教你用 go mod tidy 清理无用依赖）

什么是 go mod tidy？

go mod tidy 是 Go 模块系统中的一个命令，用于确保 go.mod 和 go.sum 文件与当前项目实际使用的依赖完全一致。它会：

• 移除所有未被项目代码直接或间接引用的依赖（即“死依赖”）
• 添加项目中使用但尚未记录在 go.mod 中的依赖
• 更新 go.sum 文件以反映最新的依赖校验和

如何使用 go mod tidy？

使用非常简单！只需在你的 Go 项目根目录（即包含 go.mod 文件的目录）下打开终端，执行以下命令：

go mod tidy

如果你希望同时清理测试文件中的依赖（默认已包含），也可以显式指定：

go mod tidy -v

其中 -v 参数会输出详细日志，告诉你哪些依赖被添加或删除了，非常适合调试。

实际操作演示

假设你有一个 Go 项目，之前引入了 github.com/sirupsen/logrus，但现在改用标准库 log，并删除了所有相关代码。但 go.mod 中仍有 logrus 的记录。

执行 go mod tidy 后，你会发现 go.mod 自动移除了 logrus 的条目：

// 执行前 go.modmodule myprojectgo 1.21require (	github.com/sirupsen/logrus v1.9.3)// 执行 go mod tidy 后go mod tidy// 执行后 go.modmodule myprojectgo 1.21// logrus 已被自动移除！

最佳实践建议

• 每次提交代码前运行 go mod tidy，确保依赖干净
• 将 go mod tidy 加入 CI/CD 流程，防止冗余依赖被合并
• 不要手动编辑 go.sum，应始终由 Go 工具链维护

总结

通过本文，你应该已经掌握了如何使用 go mod tidy 来高效管理 Go 项目的依赖。这项技能不仅能提升 Go语言依赖管理 的专业性，还能显著优化项目结构。无论是新手还是资深开发者，定期使用 go mod tidy 都是保持代码健康的重要习惯。

记住：干净的依赖 = 更安全、更轻量、更可维护的 Go 项目！

如果你正在学习 Go模块清理 或 Go项目依赖优化，不妨现在就打开终端，试试 go mod tidy 吧！