go install 报 permission denied 的根本原因是工具链 fallback 到 GOROOT（如 /usr/local/go）的只读目录写入，因 GOPATH 未正确设置或 GOBIN 未指定，导致 Go 无法定位用户可写安装路径。
go install 报 permission denied，基本就是它想往 /usr/lib/go 或 /usr/local/go 这类系统目录里写东西——你没权限，也不该有。
为什么 go install 会去写系统目录？
不是你手贱 chmod 了，而是 Go 工具链“找不到家”，默认 fallback 到 GOROOT 下的 pkg 或 bin 目录。而 GOROOT（比如 /usr/local/go）是只读安装路径，普通用户不能往里写。
-
go env GOPATH输出为空或仍是默认值（如/root/go但你不是 root），go install就可能忽略它 -
GOBIN没设，且GOPATH下没有bin/目录，工具链会退回到$GOROOT/bin - 某些旧版 Go（GOPATH，配置稍有偏差就容易出错
GOPATH 和 GOBIN 必须显式设置
别信“默认就行”，尤其在新装系统或 Docker 容器里，GOPATH 很可能根本没生效。必须手动创建目录并导出变量：
- 先建好结构：
mkdir -p $HOME/go/{src,pkg,bin} - 再设变量（以 Bash/Zsh 为例）：
export GOPATH=$HOME/go、export GOBIN=$HOME/go/bin -
PATH要包含$GOBIN：export PATH=$GOBIN:$PATH（顺序很重要，确保你自己的bin在系统路径前） - 写进
~/.zshrc或~/.bashrc，然后source ~/.zshrc
验证：运行 go env GOPATH 和 go env GOBIN，输出必须是你指定的路径，且 $HOME/go/bin 确实存在。
立即学习“go语言免费学习笔记（深入）”；
执行 go install 前先确认模块模式和代理
即使 GOPATH 配对了，如果网络不通或模块模式关着，go install 可能卡在下载依赖阶段，最后仍报权限错（其实是网络超时后 fallback 到系统路径）：
- 强制启用模块：
go env -w GO111MODULE=on - 配国内代理（否则
goproxy.io经常超时）：go env -w GOPROXY=https://goproxy.cn,direct - 关校验（开发机可选）：
go env -w GOSUMDB=off - 检查是否生效：
go env | grep -E "(GO111MODULE|GOPROXY|GOSUMDB)"
注意：go install 后接包路径（如 golang.org/x/tools/gopls@latest），不是本地文件；若装本地命令，需确保当前在 main 包目录下，且 go.mod 存在或已 go mod init。
常见误操作与隐蔽坑点
很多问题不是配置错，而是被表象误导：
-
sudo go install能跑通？立刻停手——它真把二进制写进/usr/local/go/bin了，下次你用普通用户调用，PATH 找不到，又报command not found -
go env -w GOPATH=...看似方便，但它写进的是GOENV文件，优先级低于 shell 环境变量，容易和export冲突，建议统一用export+ shell 配置文件 - 用
root用户配过环境，切回普通用户后忘了重 source，go env显示的还是 root 的路径 -
$HOME/go/bin目录权限被改过（比如chmod 700），导致其他用户或子进程无法执行里面生成的二进制，表现为“找不到命令”或“permission denied”但路径没错
最稳妥的做法：每次新开终端，先 go env GOPATH 和 ls -ld $HOME/go/bin 看一眼，再动手 go install。
