go mod tidy用于清理未使用依赖、补全缺失依赖并同步go.sum文件。执行该命令会分析代码中的import，移除go.mod中无用模块，添加缺失依赖，更新版本信息，并校验go.sum完整性。常用选项包括-v（输出详情）、-compat指定兼容版本、-droprequire/-dropreplace处理特定指令。建议在删减代码、引入新包、提交前或项目结构调整后运行，结合git diff查看变更，保持依赖整洁，防止膨胀。
在 Go 项目中，go mod tidy 是一个非常实用的命令，用于自动管理模块依赖。它能帮你清理无用的依赖、补全缺失的依赖，并保持 go.mod 和 go.sum 文件整洁。
go mod tidy 的作用
执行 go mod tidy 时，Go 工具链会分析当前项目的源代码，检查 import 的包，并根据实际使用情况调整 go.mod 文件：
- 删除 go.mod 中声明但代码中未使用的模块（无用依赖）
- 添加代码中使用了但 go.mod 中缺失的依赖
- 更新 require 指令中的版本信息，确保最小版本选择正确
- 同步 go.sum 文件，添加缺失的校验和
基本使用方法
在项目根目录（包含 go.mod 的目录）下运行：
go mod tidy
这个命令会自动完成依赖整理。如果你希望看到它做了什么，可以加上 -v 参数查看详细信息：
立即学习“go语言免费学习笔记（深入）”；
go mod tidy -v
常用选项说明
- -v：输出处理过程中的模块信息，便于排查问题
- -compat=1.17（或其他版本号）：指定兼容性检查，保留某些旧版本可能需要的间接依赖
- -droprequire 和 -dropreplace：高级用法，用于移除特定 require 或 replace 指令
例如，保留与 Go 1.19 兼容所需的间接依赖：
go mod tidy -compat=1.19
实际操作建议
在日常开发中，推荐在以下场景运行 go mod tidy：
- 删除大量代码或功能后，检查是否有残留依赖
- 引入新包但忘记执行 tidy，导致 go.mod 不完整
- 准备提交代码前，确保依赖关系干净清晰
- 升级主模块版本或迁移项目结构后
可以配合 git 使用，先提交当前状态，再运行 tidy，通过 git diff 查看依赖变化。
基本上就这些。定期使用 go mod tidy 能让项目依赖更健康，避免“依赖膨胀”问题。