轻量本地缓存模式即复用Go原生$GOPATH/pkg/mod目录，需显式执行go mod download（不可依赖go build自动下载），配合GOPROXY=https://goproxy.cn,direct、持久化缓存目录及避免误用go clean -modcache。
轻量本地缓存模式不是额外加一层缓存服务，而是让 Go 工具链原生的 $GOPATH/pkg/mod 目录真正被复用起来——关键在不破坏它、不绕过它、也不等它失效后才补救。
go mod download 必须在 go build 前显式执行
Go 不会在 go build 时“顺手”下载缺失模块；它会直接报错退出，比如 module github.com/some/pkg: not found。这不是网络问题，是设计行为。
- CI/CD 流水线里，在
go build步骤前必须加一行go mod download - 本地新克隆项目后，别急着
go run main.go，先跑go mod download -x（-x能看到是否真走代理，确认没直连失败） - 如果
go.mod里有私有模块（如git.internal.company/project），只设GOPROXY=https://goproxy.cn会导致 404；必须写成GOPROXY=https://goproxy.cn,direct
缓存目录不能每次都被清空或挂载到临时文件系统
$GOPATH/pkg/mod 是模块缓存的唯一落盘位置，但它的内容不会自动跨环境共享——尤其在容器和 CI 中，它常被建在 tmpfs 或无持久化的 layer 上。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- Docker 构建时，把
/root/go/pkg/mod单独作为 cache mount：用RUN --mount=type=cache,target=/root/go/pkg/mod go mod download - GitHub Actions 中，用
actions/cache@v4缓存~/go/pkg/mod，key 应包含go.version和go.sum的 hash，避免跨版本污染 - 不要为每个项目配独立
GOPATH；多项目共用同一$HOME/go，pkg/mod自动复用，手动隔离反而浪费空间
别把 go clean -modcache 当日常操作
go clean -modcache 是故障恢复手段，不是“刷新缓存”的常规动作。它会删光整个 pkg/mod，下次构建就得重下全部依赖。
立即学习“go语言免费学习笔记（深入）”；
- 缓存损坏的典型表现是：
checksum mismatch、invalid version、或反复下载同一模块（日志里出现多次downloading github.com/xxx v1.2.3） - 日常开发中频繁执行该命令，只会让构建变慢；真正该定期做的，是检查缓存体积：
du -sh $GOPATH/pkg/mod，超 5GB 且长期不清理，说明积压了大量旧版模块 - 如果你在 CI 中每次构建前都加
go clean -modcache，等于主动放弃缓存价值——除非你明确需要隔离构建环境
最容易被忽略的一点：缓存是否生效，不能只看有没有报错，而要看 go build -x 输出里是否出现 cached 或完全不出现 curl 请求。一旦看到 finding 或 downloading，就说明某处配置断了链路——不是代理没配对，就是缓存路径被覆盖或清空了。
