根本原因是gopath或gobin未正确配置，导致go install回退到只读的$goroot/pkg目录；应显式设置gopath=$home/go、gobin=$home/go/bin并创建对应目录结构，避免sudo或chmod破坏系统安全机制。
直接用 sudo go install 能临时跑通，但大概率会让后续所有 go 命令行为异常——比如新装的 gopls 被写进 /usr/local/go/，导致普通用户无法更新或删除，反而更难收场。
go install 报 permission denied 指向 /usr/local/go/pkg/
这是最典型的信号：Go 工具链误把用户代码当系统工具装了。根本原因不是你没权限，而是 GOPATH 没生效，或者 GOBIN 为空，导致 go install 回退到写 $GOROOT/pkg/（只读区）。
- 先执行
go env GOPATH GOBIN GOROOT，确认GOPATH是否为空或指向系统路径（如/usr/lib/go） - 若
GOPATH为空，必须显式设置，例如：export GOPATH=$HOME/go - 务必手动创建目录结构：
mkdir -p $HOME/go/{src,pkg,bin}，否则 Go 不认这个路径为合法工作区 - 如果
GOBIN为空，go install会默认用$GOPATH/bin；但显式设成export GOBIN=$HOME/go/bin更稳妥，避免多GOPATH时选错 bin 目录
vscode 的 gopls 或 go-outline 安装失败
VS Code 的 Go 插件底层调用的仍是 go install，所以权限问题一模一样。但这里还有个隐藏坑：插件默认用系统 PATH 里的 go，而你可能改了 shell 配置却没刷新 VS Code 的环境。
- 在 VS Code 终端里运行
which go和go env GOPATH，结果必须和你终端里一致；不一致就说明 VS Code 没读取你的~/.zshrc或~/.bashrc - 不要用
sudo chmod -R 777 /usr/local/go/bin——这会让所有工具二进制变成世界可写，下次go install可能覆盖掉go自身 - 正确做法是让插件走用户路径：在 VS Code 设置里搜
go.gopath，填入$HOME/go；再搜go.gobin，填入$HOME/go/bin - 重启 VS Code（不是重开窗口），让它彻底重载环境
Mac 上提示“以超级用户身份重试”
macOS 对 /usr/local 下目录有更严格的权限控制（尤其 SIP 启用时），即使你是管理员，go install 写 /usr/local/go 也会被拦截。这不是 bug，是系统设计。
- 别碰
/usr/local/go的权限，SIP 可能随时重置它；也不要试图sudo chown整个目录 - 改用用户级安装：从 https://go.dev/dl/ 下载 .pkg 文件，安装时选择“仅当前用户”，它会把 Go 放进
$HOME/sdk/go并自动配好GOROOT - 如果已装系统级 Go，就老老实实配好
GOPATH和GOBIN，所有go install都走$HOME/go/bin，和系统 Go 彻底解耦 - 验证是否生效：装完
gopls后，运行which gopls，输出必须是$HOME/go/bin/gopls，而不是/usr/local/go/bin/gopls
最容易被忽略的一点：Go 1.16+ 的 go install path@version 语法默认走 $GOPATH/bin，但如果你设置了 GOBIN，它就只认 GOBIN；而旧版 Go（如 1.12）根本不识别 @version，仍会尝试写 GOTOOLDIR。版本混用时，错误信息看起来一样，根因却完全不同。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
