多用户共享服务器上golang环境必须按用户隔离安装，每个用户需在家目录独立解压官方二进制包并显式设置goroot、gopath、gobin、gocache为私有路径，禁用go env -w，ci/cd须用login shell加载环境。
多用户共享服务器上，Golang 环境必须按用户隔离安装，否则 go build、go mod download 和 go install 会相互干扰甚至损坏缓存 —— 这不是配置问题，是 Go 工具链对 GOCACHE、pkg 目录的并发写入机制决定的。
每个用户必须独立安装 Go 到家目录
系统级安装（如 sudo apt install golang 或解压到 /usr/local/go）会让所有用户共用同一 GOROOT，但不同项目可能依赖不同 Go 版本；更严重的是，某些发行版包管理器提供的 Go 缺少 src 和 pkg 目录，导致 go build -buildmode=shared 失败。
- 执行：
mkdir -p ~/local/go，然后下载并解压官方二进制包：curl -sL https://go.dev/dl/go1.22.5.linux-amd64.tar.gz | tar -C ~/local -xzf - - 在
~/.bashrc或~/.zshrc中添加：export GOROOT=$HOME/local/go和export PATH=$GOROOT/bin:$PATH -
source ~/.bashrc后验证：go version应输出对应版本，go env GOROOT必须等于$HOME/local/go - ARM64 服务器请换用
go1.22.5.linux-arm64.tar.gz，否则运行go version会报cannot execute binary file: Exec format error
GOPATH、GOBIN、GOCACHE 必须显式设为用户私有路径
默认不设时，Go 会 fallback 到 $HOME/go，但在 NFS 挂载或共享 home 目录的服务器上，go mod download 的并发写入极易损坏 $GOCACHE 或 pkg/ 目录。
- 统一设置：
export GOPATH=$HOME/go（保持结构，但确保属主明确） -
export GOBIN=$HOME/bin（避免和/usr/local/bin混淆；确认$HOME/bin已在PATH中） -
export GOCACHE=$HOME/.cache/go-build（防 NFS 锁争用；若服务器禁用 home 缓存，改用/tmp/$USER/go-cache） - 不要把
GOPATH设为/usr/local/go—— 这会干扰GOROOT，导致go build找不到标准库
禁用 go env -w，只用 shell 环境变量初始化
go env -w 把配置写入 $HOME/go/env，看似只影响当前用户，但该文件无权限校验；若某用户误执行 sudo go env -w GOROOT=/usr/local/go，后续所有 su 切换用户都会继承错误值。更隐蔽的是，go env -w 设置的变量优先级高于 export，容易掩盖调试线索。
- 所有配置必须通过 shell 环境变量完成，例如：
export GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct - 私有仓库需跳过代理：
export GOPRIVATE=git.example.com - CI/CD 或定时任务必须用 login shell（如
bash -l -c "go build"）加载完整环境，否则~/.bashrc不生效 - 验证：
go env GOPROXY GOPRIVATE输出应匹配设置；运行go mod download golang.org/x/net测试拉取是否成功
编译时注意模块模式与输出路径分离
Go 1.16+ 默认启用模块模式，GOPATH 不再决定构建路径，但 go install 仍默认把二进制放到 $GOPATH/bin。若多个用户共用 $HOME/go/bin，会覆盖彼此工具。
- 确保
GOBIN指向用户专属路径（如$HOME/bin），且该路径已在PATH前置位置 - 构建生产二进制建议用静态链接：
CGO_ENABLED=0 go build -ldflags="-s -w" -o ./myapp ./cmd/myapp - 不要在生产机上直接
go run main.go—— 它隐式编译到临时目录、残留进程、无法管理生命周期，也不支持日志重定向 - 若项目含
replace或本地模块引用，务必在模块根目录下操作；跨模块协作建议用go work init+go work use生成go.work文件，否则gopls和go build可能解析失败
最容易被忽略的是：NFS 挂载 home 目录时，GOCACHE 和 pkg/ 的锁争用不会立刻报错，而是表现为随机的 build cache is invalid 或依赖下载中断 —— 这时要检查 GOCACHE 是否真的落在本地磁盘而非挂载点。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
