只要go.mod和go.sum还在就能重建依赖；真正不可逆丢失的只有这两个文件（go.sum可重生成但需网络校验），常见失败源于GOPROXY不可用或缓存损坏，应设GOPROXY=direct再执行go mod tidy。
go mod tidy 失败且 vendor 目录丢失时怎么救
只要 go.mod 和 go.sum 还在，就能重建依赖；真正不可逆丢失的只有这两个文件（go.sum 可重生成但需网络校验）。常见错误是 go mod tidy 卡住或报 no required module provides package —— 这往往不是模块真没了，而是 GOPROXY 不可用或本地缓存损坏。
- 先临时禁用代理：设置
GOPROXY=direct，再跑go mod tidy，绕过中间缓存层 - 若仍失败，检查
go.mod中是否有私有模块路径（如gitlab.example.com/group/lib），确认对应 Git 服务可访问；不可达时用go mod edit -replace=gitlab.example.com/group/lib=../local-fork指向本地副本 - vendor 目录丢失不用慌：
go mod vendor会重新拉取所有依赖，但必须确保go.sum存在且未被篡改——否则go build -mod=vendor会在校验阶段直接 panic
私有模块仓库宕机时如何强制走本地 vendor
当公司内部 Git 服务器或私有 Go proxy 全挂，go build 默认仍会尝试联网验证 go.sum，导致构建中断。这不是 vendor 无效，而是 Go 工具链的默认安全策略在作祟。
- 必须加
-mod=vendor参数：仅go mod vendor生成目录不够，构建命令必须显式声明go build -mod=vendor - 禁止校验哈希：设环境变量
GOSUMDB=off，否则即使有 vendor，Go 仍会尝试连接 sum.golang.org 或私有 sumdb - 注意
go run也受此影响：它底层调用 build，所以也要写成go run -mod=vendor .
go.sum 被误删或内容损坏怎么办
go.sum 不是“可选文件”，它是依赖完整性的最后一道防线。一旦缺失或哈希错位，go mod download 可能静默替换掉某个间接依赖的恶意版本，而你完全不知情。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 别用
go mod init重生成：它只会生成空go.sum，后续go mod tidy会拉取最新版并写入新哈希，破坏锁定语义 - 正确做法是重跑
go mod download+go mod verify：前者从go.mod拉取所有模块到本地缓存，后者比对缓存中模块的哈希与go.sum记录（若go.sum空则报错，此时才允许go mod tidy补全） - 若连
go.mod都丢了，唯一可靠来源是 Git 历史 ——git checkout HEAD~1 -- go.mod go.sum，而不是靠记忆手写
跨 region 构建时 vendor 内容不一致的坑
在多 region CI 环境（比如杭州和深圳两个构建集群）中，即使 go.mod 相同，go mod vendor 输出的 vendor 目录也可能不同——根源在于 Go 的 module resolution 会受 GOPROXY 响应顺序影响，尤其当 proxy 返回 503 时 fallback 到 direct 的时机不一致。
立即学习“go语言免费学习笔记（深入）”；
- 解决方案不是“统一 proxy”，而是固定解析顺序：在 CI 脚本开头加
export GOPROXY=https://proxy.golang.org,direct，确保 fallback 总是 direct，避免 region 间差异 - 提交 vendor 前务必运行
go mod vendor && git diff --quiet vendor || git add vendor，防止有人跳过 vendor 更新直接提交 - 最狠但有效的一招：CI 流程末尾加校验步骤
go mod vendor && ! git diff --quiet vendor，有差异就 fail，逼所有人同步
真正的灾备恢复难点不在“怎么拉代码”，而在“怎么确认拉下来的代码和线上运行的一致”。go.sum 是唯一可信锚点，但它不会自己说话——你得让 CI 把它的校验结果打印出来，让每次构建日志里都带一句 sum verified: ok，否则所谓“可恢复”只是幻觉。
