Go mod tidy清理无用依赖方法

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 的目录）下运行：

这个命令会自动完成依赖整理。如果你希望看到它做了什么，可以加上 -v 参数查看详细信息：

常用选项说明

• -v：输出处理过程中的模块信息，便于排查问题
• -compat=1.17（或其他版本号）：指定兼容性检查，保留某些旧版本可能需要的间接依赖
• -droprequire 和 -dropreplace：高级用法，用于移除特定 require 或 replace 指令

例如，保留与 Go 1.19 兼容所需的间接依赖：

实际操作建议

在日常开发中，推荐在以下场景运行 go mod tidy：

• 删除大量代码或功能后，检查是否有残留依赖
• 引入新包但忘记执行 tidy，导致 go.mod 不完整
• 准备提交代码前，确保依赖关系干净清晰
• 升级主模块版本或迁移项目结构后

可以配合 git 使用，先提交当前状态，再运行 tidy，通过 git diff 查看依赖变化。