go install报permission denied的真实原因是Go工具链未找到用户可写安装路径而fallback至GOROOT只读目录；需显式设置GOPATH和GOBIN、创建对应目录、加入PATH并验证，同时确保代理通畅。

go install 报 permission denied 的真实原因

根本不是权限不够，而是 Go 工具链“迷路”了——它找不到你指定的安装路径，只能 fallback 到 GOROOT 下的只读目录（比如 /usr/lib/go/bin 或 /usr/local/go/pkg），而你当然没权限写那里。

典型错误信息长这样：go install github.com/jbarham/primegen.go: mkdir /usr/lib/go/pkg/linux_amd64/github.com: permission denied。这不是你该去 sudo chmod 的地方，是配置没生效。

• go env GOPATH 输出为空、或仍是默认值（如 /root/go 但你不是 root）
• GOBIN 没设，且 $GOPATH/bin 目录压根不存在
• 即使 GOPATH 显示正确，但 shell 没 reload 配置，变量实际未加载

必须显式创建并导出 GOPATH 和 GOBIN

别信“新版 Go 不用配 GOPATH”，go install 仍依赖它来定位 bin 目录；不设 GOBIN 就等于把钥匙交给工具链让它猜——它大概率猜错。

执行以下三步（Bash/Zsh）：

• 建目录：mkdir -p $HOME/go/{src,pkg,bin}
• 设变量：export GOPATH=$HOME/go 和 export GOBIN=$HOME/go/bin
• 加进 PATH：export PATH=$GOBIN:$PATH（顺序不能反，否则系统 go 可能覆盖你自己的）

写入 ~/.zshrc 或 ~/.bashrc 后，务必 source ~/.zshrc。验证：运行 go env GOPATH 和 go env GOBIN，输出必须是你刚设的路径，且 ls $GOBIN 应返回空（说明目录存在且可写）。

go mod 场景下仍可能触发权限问题

启用 go mod 后，go get 下载的依赖会存到 $GOPATH/pkg/mod，但 go install 生成的二进制文件仍走 GOBIN 或 $GOPATH/bin。如果这两个没配，它照样 fallback 到 GOROOT。

常见误判点：

• 以为开了 GO111MODULE=on 就不用管 GOPATH ——错，go install 不看模块开关，只认 GOBIN 或 GOPATH
• 只配了 GOPATH，忘了 mkdir -p $GOPATH/bin，导致工具链发现目录不存在，直接退回到 $GOROOT/bin
• 在 Docker 容器里跑，~/.zshrc 根本没 source，环境变量全是空的

代理不通时也会伪装成权限错误

网络卡住、GOPROXY 配错、或 GOSUMDB 校验失败，都可能导致 go install 超时后放弃下载，转而尝试把未完成的中间产物往 GOROOT 写——这时报的还是 permission denied，但根源是网络。

快速排查：

• 先试 curl -I https://goproxy.cn，确认代理可达
• 检查 go env GOPROXY，推荐设为 https://goproxy.cn,direct
• 开发阶段可临时关校验：go env -w GOSUMDB=off（上线前务必恢复）

真正棘手的从来不是权限本身，而是错误信息在撒谎——它说“没权限”，其实是在喊“我找不到家”。配好 GOBIN，建好 bin 目录，再确认代理通了，99% 的 case 就消失了。