详解Go语言模块依赖的缓存共享与权限设置-Golang-PHP中文网

不能共享gocache和gomodcache，因gocache绑定cgo_enabled、go版本等上下文，混用导致静默链接失败；gomodcache不校验内容，易被篡改且nfs下锁失效引发permission denied；二者及goroot、gobin均须按用户隔离并显式配置。

详解go语言模块依赖的缓存共享与权限设置

为什么不能共享 `GOCACHE` 和 `GOMODCACHE`

共享缓存不是提速手段，而是故障源头。Go 的 GOCACHE 存的是带构建上下文的二进制中间产物（比如 .a 文件），它隐式绑定：CGO_ENABLED、GOOS/GOARCH、Go 版本、甚至底层 gcc 版本。两个用户若分别用 CGO_ENABLED=0 和 CGO_ENABLED=1 编译过同一包，缓存里就会混入不兼容对象，链接时出现 undefined reference to 'xxx' 这类静默失败——源码明明有定义，但就是连不上。

GOMODCACHE（即 $GOPATH/pkg/mod）虽只存源码压缩包，但它不做内容校验：A 用户改过某个模块里的文件，B 用户 go build 时仍会直接复用，go mod verify 不报错，但行为已不可控。NFS 挂载下更糟：flock 锁失效，多个 go mod download 进程同时写 cache.lock，直接触发 Permission denied 或 cannot lock cache directory。

`GOCACHE` 和 `GOMODCACHE` 必须按用户隔离

每个用户必须在 shell 初始化文件（如 ~/.bashrc）中显式设置私有路径，且不能依赖 go env -w：

export GOCACHE=$HOME/.cache/go-build —— 若 home 是 NFS 挂载，建议改用本地磁盘：export GOCACHE=/tmp/$USER/go-cache
mkdir -p /tmp/$USER/go-cache && chmod 700 /tmp/$USER/go-cache —— 确保目录属主明确、无其他用户可写
export GOPATH=$HOME/go —— 避免 fallback 到系统级只读路径
export GOMODCACHE=$GOPATH/pkg/mod —— 显式声明，防止被 CI 脚本误清理（go clean -modcache 会清掉所有人的缓存）

`GOROOT` 不能共用，也不能设为系统路径

用 sudo apt install golang 或解压到 /usr/local/go 会让所有人共享同一 GOROOT，这会导致两个问题：

一是不同项目需要 Go 1.21 和 Go 1.22 并存，系统级安装无法支持；二是某些发行版提供的 Go 包缺失 src 和 pkg 目录，导致 go build -buildmode=shared 直接失败。更隐蔽的问题是：go install 有时会尝试往 $GOROOT/pkg 写缓存，而该目录属主为 root，普通用户无写权限，报 permission denied 却不提示具体路径。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

正确做法是每人独立解压：

mkdir -p ~/local/go
curl -sL https://go.dev/dl/go1.22.5.linux-amd64.tar.gz | tar -C ~/local -xzf -
export GOROOT=$HOME/local/go
export PATH=$GOROOT/bin:$PATH