go mod tidy 通过分析代码自动清理未使用依赖并添加缺失依赖，更新 go.mod 和 go.sum 文件，保留间接依赖、测试依赖及工具依赖，确保项目依赖整洁与安全。
在 Go 项目中，保持依赖的整洁是维护项目健康的关键。无效或未使用的依赖不仅会让 go.mod 文件变得混乱，还可能带来潜在的安全风险和构建问题。解决这个问题的核心命令就是 go mod tidy。
go mod tidy 做了什么？
go mod tidy 是 Go 工具链提供的一个智能命令，它会分析你的整个项目代码，并根据实际需要自动调整 go.mod 和 go.sum 文件。它的主要工作可以概括为“一增一减”：
-
减：移除无用依赖 它会扫描项目中所有的
.go文件，找出所有被import的包。任何在go.mod的require列表里，但你的代码中完全没有引用到的直接依赖，都会被删除。 -
增：补全缺失依赖 如果你的代码引用了某个包，但这个包没有在
go.mod中声明，go mod tidy会自动将其添加进去，并选择一个合适的版本。 -
更新校验和文件 它会同步更新
go.sum文件，确保其中包含当前项目所需的所有依赖项的正确哈希校验和，移除那些不再需要的旧条目。
哪些“看似无用”的依赖不会被删除？
你可能会发现，执行 go mod tidy 后，一些看起来没在主代码里用的依赖还在。这通常是因为它们确实是必要的，只是使用方式比较隐蔽：
-
间接依赖 (Indirect Dependencies) 这是最常见的原因。如果你的项目直接依赖 A 库，而 A 库又依赖 B 库，那么 B 库就会作为间接依赖保留在
go.mod中，并标记为// indirect。虽然你的代码不直接导入 B，但 A 需要它才能正常工作，所以不能删。 -
测试代码的依赖 只在
*_test.go文件中被导入的库会被保留。因为测试是项目功能完整性的组成部分，Go 认为这些依赖是有效的。 -
通过构建标签 (Build Tags) 条件性引入的依赖 如果某些依赖只在特定平台（如
linux）或自定义标签下才会被导入，而你运行go mod tidy的环境不满足这些条件，工具可能无法检测到这些依赖，理论上它们可能被误删。但在标准实践中，为了安全，这类依赖有时会显式保留在go.mod中。 -
工具依赖 (Tool Dependencies) 像代码生成器（如
protoc-gen-go）、linter 等开发工具，如果按推荐方式通过_ "golang.org/x/tools/cmd/stringer"这种形式在专门的文件（如tools.go）中导入，并用//go:build tools标记，go mod tidy会识别并保留它们。
如何正确使用 go mod tidy 清理依赖？
清理无效依赖的操作非常简单，只需在你的项目根目录（即包含 go.mod 文件的目录）下执行一条命令：
立即学习“go语言免费学习笔记（深入）”；
go mod tidy执行后，检查 go.mod 和 go.sum 文件的变化。建议将这些更改提交到版本控制系统中。这是一个安全且推荐的做法，可以在每次修改大量代码、合并分支或发布新版本前运行，以确保依赖关系的准确性。
基本上就这些。
