go mod tidy 是用于同步 go.mod 和 go.sum 的核心命令，自动增删依赖并更新校验和，但不清理模块缓存、源文件或 vendor 目录；它通过扫描导入图识别并移除无 import 引用、非传递依赖且未显式声明的“无用依赖”。
go mod tidy 是 Go 模块管理中用于同步 go.mod 和 go.sum 文件的核心命令，它能自动添加缺失的依赖、删除未被代码直接或间接引用的模块，并更新校验和。但它不会删除本地磁盘上的整个 module cache（即 $GOPATH/pkg/mod），也不会清理项目目录下无关的源文件或二进制产物。
什么是“无用依赖”？go mod tidy 如何识别它们
Go 认为“无用依赖”是指：
– 在当前模块的 .go 源文件中没有 import 语句引用该模块；
– 且该模块未被其他已保留的依赖所依赖（即不是传递依赖）；
– 同时也不在 replace、exclude 或 require 中被显式声明（除非是间接依赖但已被标记为 // indirect）。
当运行 go mod tidy 时，Go 工具链会：
– 扫描所有 .go 文件，构建完整的导入图；
– 对比当前 go.mod 中的 require 列表；
– 移除那些不在导入图中、也非必要传递依赖的模块条目；
– 自动将仍被需要但未出现在主 require 中的模块标记为 // indirect。
正确使用 go mod tidy 清理依赖的步骤
确保你在项目根目录（含 go.mod 的目录）下执行以下操作：
- 先提交或备份当前代码，避免误删导致编译失败
- 运行
go mod tidy，它会自动： – 添加缺失的依赖（如新 import 了某个包但没加到 go.mod） – 删除未被引用的require行 – 更新go.sum校验和 - 检查输出日志，关注是否出现
removing unused requirement提示 - 运行
go build ./...或go test ./...确保功能未被破坏 - 如有必要，可配合
go list -m all查看当前解析出的所有模块及其版本
go mod tidy 不会做的事（常见误解）
它不会：
立即学习“go语言免费学习笔记（深入）”；
- 删除
$GOPATH/pkg/mod缓存目录里的旧版本模块（需手动用go clean -modcache） - 清理项目中自己写的、未被任何 import 引用的 .go 文件（这些是源码，不是依赖）
- 删除 vendor 目录（如果存在），vendor 是独立机制，tidy 默认不触碰它（除非加
-v参数且启用 vendor 模式） - 处理被
// +build或构建标签屏蔽、实际未参与构建的 import（tidy 会保留它们，因静态分析无法确定是否启用）
进阶：彻底清理本地模块缓存（可选）
若想释放磁盘空间、清除所有下载过的模块版本：
- 执行
go clean -modcache—— 这会清空$GOPATH/pkg/mod - 之后再运行
go mod tidy，Go 会按需重新下载当前所需的最小版本集合 - 注意：这会影响后续构建速度（首次需重下），适合 CI 环境或换机器后使用
