go mod tidy只删除既无import引用也无间接依赖的模块，需人工验证反射、配置驱动及测试专用模块；加-v同步vendor，用go mod why和graph分析真实依赖路径。
go mod tidy 不会自动删掉你“觉得没用”的模块，它只删代码里真没 import、也没被任何构建路径引用的模块。运行前不检查条件编译或测试文件，很可能删掉关键依赖导致 go build 失败。
什么时候必须先跑 go mod tidy？
不是“想清理就跑”，而是这几个场景下它直接决定能否正常构建：
- 刚
git clone一个 Go 项目，go.mod里缺依赖或版本混乱，不执行就go build报错 - 删了某个
import语句但没手动改go.mod，里面还留着旧模块，go mod tidy才会真正移除 - 新增了
_test.go文件并 import 了新包，不 tidy 就没法拉取测试依赖，go test直接失败 - CI 流水线里检测到
go.mod或go.sum被修改，说明本地没 tidy 就提交了，必须阻断
go mod tidy 为什么没删掉那个“明显没用”的模块？
它不是靠人眼判断，而是基于静态分析结果做决策。以下情况都会让模块“幸存”：
- 该模块被某个已保留依赖的
go.mod显式require，哪怕你代码里没 import ——go mod graph | grep module-name能查清来源 - 有
//go:build linux或//go:embed引用了它，但当前环境（比如 macOS）下静态分析没触发构建标签 - 用了空白导入：
import _ "github.com/some/pkg"，go mod tidy认为这是显式需要 - 模块被
go:generate注释间接引用，但没加//go:generate构建约束，tidy 默认忽略
vendor 目录没更新？不是 bug，是默认行为
go mod tidy 只同步 go.mod 和 go.sum，完全不碰 vendor/。要让它跟上变化，必须加 -v 参数：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 执行
go mod tidy -v：重新填充vendor/，但不会自动清理旧文件 - 想彻底干净：先
rm -rf vendor/，再go mod tidy -v - 注意：
go mod vendor是等价命令，但它不先 tidy —— 如果go.mod本身冗余，vendor/就会塞进无用包
国内环境卡住或校验失败怎么办？
超时、checksum mismatch、unknown revision 这些错误基本都和代理配置有关：
- 设代理：
go env -w GOPROXY=https://goproxy.cn,direct（阿里云镜像也行） - 私有模块必须加：
go env -w GOPRIVATE=git.internal.company.com/*，否则会走 public proxy 导致 404 - 遇到 checksum 错误，别急着删
go.sum，先确认是不是某次手动改过go.mod版本号却没跑 tidy；更稳妥的是go mod verify检查完整性 - 调试卡点：加
-x参数看具体哪一步 hang 住，通常是某个模块的go list -m -json请求失败
最容易被忽略的点是：tidy 的分析范围取决于当前构建环境。GOOS、GOARCH、构建标签、是否包含测试文件——这些都会改变导入图。同一份代码，在不同环境下跑 go mod tidy，生成的 go.mod 可能不一样。
