go mod tidy 卡住时，先检查失败模块是否为 golang.org/x/ 类路径，因 goproxy 未覆盖或 goprivate 漏配导致隐式代理请求失败；应配置多源 fallback 的 goproxy（如 https://goproxy.cn,https://proxy.golang.org,direct）、精确匹配的 goprivate 及 gosumdb，并确保 vscode 继承环境变量或通过 toolsenvvars 补充配置。
go mod tidy 卡住时，先看失败模块是不是 golang.org/x/ 类路径
混合网络下 go mod tidy 卡在 fetching dependencies，90% 不是网速慢，而是模块解析阶段触发了隐式代理请求。比如依赖里写了 golang.org/x/net，但 GOPROXY 没包含能响应它的镜像源，或 GOPRIVATE 漏配导致它被错误转发到私有 Git 服务器。
快速定位方法：
- 运行
go mod graph | head -20查看顶层依赖是否含golang.org/x/类路径 - 执行
go list -m all 2>&1 | grep -i "timeout\|refused\|404"找出具体失败模块 - 对失败模块手动试拉：
go get -v golang.org/x/net@latest，观察卡在哪一环
GOPROXY 必须用逗号分隔多源并 fallback，不能只设一个
单一 GOPROXY 值无法覆盖混合网络全部场景：国内直连失败、公司内网走代理、私有模块不走镜像——强行统一会导致私有仓库（如 git.corp.com/internal/pkg）被强制走公网镜像，报 404 或认证失败。
正确写法是：
-
GOPROXY=https://goproxy.cn,https://proxy.golang.org,direct：按顺序尝试，失败则 fallback -
GOPRIVATE=*.corp.com,github.com/your-org/private-repo：匹配到的域名跳过所有 proxy，直连 -
GOSUMDB=sum.golang.google.cn：避免sum.golang.org超时
配置后务必执行 source ~/.zshrc（或对应 shell 配置文件），再用 go env GOPROXY GOPRIVATE GOSUMDB 确认三者都生效。
VSCode 中 go.mod 自动更新失效，大概率是环境变量没继承
GUI 启动的 VSCode（比如点击图标）在 macOS 上通常不加载 ~/.zshrc，导致 GOPROXY 等变量为空，go mod tidy 在编辑器内静默失败。
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
两个可靠解法：
- 终端中启动：
code .，这样继承当前 shell 环境 - 在项目
.vscode/settings.json中硬编码："go.toolsEnvVars": { "GOPROXY": "https://goproxy.cn,direct" }
注意：go.toolsEnvVars 只影响 VSCode 内部命令；go mod download 等终端命令仍依赖系统级环境变量，所以两者最好同时配。
私有模块 401/403 别只改 token，先确认 git 命令能否通
报错 401 Unauthorized 或 403 Forbidden 本质是 git 认证问题，不是 Go 模块系统的问题。Go 在拉取私有模块时会调用系统 git 命令，如果 git clone https://git.internal.company.com/lib/foo 本身失败，go get 也必然失败。
验证和修复步骤：
- 手动运行
git clone https://git.internal.company.com/lib/foo，看是否要输密码或 token - 若需认证，配置 git credential helper：
git config --global credential.helper store，然后跑一次 clone 触发存储 - 确保
GOPRIVATE精确匹配其域名（*.internal.company.com支持通配，但不支持嵌套二级子域）
最容易被忽略的是：即使 GOPRIVATE 配对了，git 命令不通，Go 依然会卡在认证环节，且错误信息不提示 git 层面的问题。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
