Go构建缓存默认路径为：macOS是$HOME/Library/Caches/go-build，Windows是$HOME/AppData/Local/go-build，Linux是$HOME/.cache/go-build；未设GOCACHE时自动启用该路径，用于加速build/test。
Go 构建缓存默认存在哪？GOCACHE 不设也会自动启用
Go 1.10+ 默认开启构建缓存，路径由 GOCACHE 环境变量控制；没显式设置时，Go 自动选一个系统默认位置：$HOME/Library/Caches/go-build（macOS）、$HOME/AppData/Local/go-build（Windows）、$HOME/.cache/go-build（Linux）。这个目录不是临时的，它长期保存编译中间产物（如 .a 文件、语法分析结果），直接影响 go build 和 go test 的速度。
常见错误现象：go build -a 变慢但 go clean -cache 后又快了——说明缓存已损坏或磁盘满；或者 CI 环境反复 clone 项目却没提速，其实是缓存目录被清空或未复用。
-
GOCACHE是纯构建缓存，和GOPATH/pkg（旧式安装缓存）无关，两者互不干扰 - 只要
GOCACHE目录可写且不为空，Go 就会读取命中，跳过重复编译 - 跨 Go 版本时缓存自动失效（比如从 1.21 升级到 1.22），不会误用旧数据
怎么改缓存路径？设 GOCACHE 环境变量最直接
修改方式就是导出环境变量，没有其他配置文件或命令行开关。它在 shell 启动时设一次，所有后续 go 命令都会继承。
使用场景：CI 中挂载 SSD 目录加速；容器里把缓存映射到 volume 避免每次重建丢失；开发机上迁移到大容量盘防止 /home 被占满。
立即学习“go语言免费学习笔记（深入）”；
- Linux/macOS：
export GOCACHE=/path/to/fast/cache（加到~/.bashrc或~/.zshrc） - Windows cmd：
set GOCACHE=D:\go-cache - Windows PowerShell：
$env:GOCACHE="D:\go-cache" - Dockerfile 中：
ENV GOCACHE=/tmp/go-cache（注意确保该路径可写）
go clean -cache 清的是什么？不是删整个目录
go clean -cache 只清理缓存中“过期”或“无效”的条目，比如源码已删、依赖版本变动、Go 工具链升级后的残留。它不会清空整个 GOCACHE 目录，也不会碰你手动放进去的文件。
容易踩的坑：go clean -cache 执行后 du -sh $GOCACHE 发现大小几乎没变——这正常，因为 Go 保留了最近活跃的缓存项；真正想彻底清空，得手动 rm -rf $GOCACHE/*（注意别删错父目录）。
- CI 流水线里建议用
go clean -cache而非rm -rf，避免因并发构建导致缓存误删 -
go clean -cache不影响go install编译的二进制，那些在$GOPATH/bin或$GOBIN里 - 如果缓存目录磁盘满，
go build会报错write $GOCACHE/xxx: no space left on device，这时必须手动清空
缓存路径权限和性能要注意什么？
GOCACHE 目录必须对当前用户可读写，且不能是 NFS 或某些 FUSE 文件系统（如早期 macOS 的 APFS 加密卷可能有 stat 性能问题）。Go 在缓存读写时不做锁粒度优化，高并发构建（比如 make -j8 跑多个 go test）下，目录 I/O 是瓶颈点。
性能影响明显的情况：缓存放在机械硬盘、远程挂载盘、或容器里用默认 overlayfs 存储驱动时，首次构建可能比禁用缓存还慢。
- 确认路径权限：
ls -ld $GOCACHE，确保输出里有drwx和当前用户标识 - Linux 上可用
find $GOCACHE -type f | head -20 | xargs ls -lh看缓存文件是否大量碎片化（小文件过多） - macOS 上若发现
go build卡在 “loading cache key” 几秒，可能是 Spotlight 正在索引GOCACHE目录，用mdutil -i off $GOCACHE关掉索引
缓存路径本身没特殊格式要求，但别设成符号链接指向网络路径，Go 不做透明重定向，链接失效就直接报错退出。
