go mod tidy 用于整理Go模块依赖，它会分析源码并更新go.mod和go.sum文件，添加缺失依赖、移除未使用项、补全测试依赖及校验和。执行 go mod tidy 可保持依赖整洁，建议在重构后运行；结合 go mod vendor、go mod verify 等命令可进一步优化管理。注意检查测试文件和子包引用，避免误删，CI/CD中可用 go mod tidy -check 验证依赖状态。定期使用可维持项目健康。
Go 语言的模块系统（Go Modules）从 Go 1.11 引入以来，已经成为管理依赖的标准方式。在开发过程中，随着功能迭代，项目依赖可能会变得混乱：有些包不再使用但仍保留在 go.mod 中，有些间接依赖未正确更新，或者版本冲突未处理。这时，go mod tidy 就是一个非常关键的命令，用于整理和优化模块依赖。
go mod tidy 是什么？
go mod tidy 命令会分析当前模块中的所有 Go 源文件，根据实际导入的包来修正 go.mod 和 go.sum 文件。它的主要作用包括：
- 添加缺失的依赖（代码中用了但 go.mod 没记录）
- 移除未使用的依赖（go.mod 中存在但代码没引用）
- 确保 go.sum 包含所有需要的校验和
- 重新计算并精简 require 列表，包括主模块和测试依赖
它不会改变你显式 go get 安装的版本，但会基于实际使用情况清理冗余项。
如何使用 go mod tidy 整理依赖
在项目根目录（包含 go.mod 的目录）执行以下命令：
立即学习“go语言免费学习笔记（深入）”；
go mod tidy
执行后，你会看到 go.mod 和 go.sum 被自动更新。常见变化包括：
- 某些第三方包从 require 列表中消失（因为不再 import）
- 新增之前遗漏的依赖（比如某个 struct 来自未声明的包）
- 补全测试所需的依赖（_test.go 中用到的包）
建议每次删除功能或重构代码后运行一次，保持依赖清爽。
结合其他命令优化模块管理
单独使用 go mod tidy 已经很强大，但配合其他命令能更彻底地优化模块结构：
- go mod vendor：生成 vendor 目录，将所有依赖复制进来，适合离线构建或锁定依赖路径
- go mod verify：检查当前模块的依赖是否被篡改，确保安全性
- go list -m all | grep 已知包名：查看某个依赖的实际版本和来源
- go get package@latest：升级特定包后再运行 tidy，可同步更新依赖树
如果发现某些依赖无法清除，可以检查是否在测试文件、内部子包或条件编译中被引用。
避免常见问题的小技巧
使用 go mod tidy 时，有时会出现意料之外的结果，以下是一些实用建议：
- 确保所有源码文件都符合当前模块的导入路径，避免因 import 错误导致误删
- 如果项目包含多个 main 包或工具命令，确认它们都被正确扫描到
- CI/CD 流程中建议加入 go mod tidy -check 来验证 go.mod 是否已整洁
- 不要手动编辑 go.mod，应通过 go 命令操作，再用 tidy 自动调整
基本上就这些。定期运行 go mod tidy，就像清理房间一样，能让你的 Go 项目始终保持健康、可维护的状态。不复杂但容易忽略。