答案是Go工具链误将GOROOT当用户工作区写入导致权限错误，因GOPATH/GOBIN未正确设置或环境变量未生效；新项目应启用Go Modules，仅需GOPATH存二进制工具，GOBIN须设为$GOPATH/bin并加入PATH。
为什么 go version 能运行但 go install 报 permission denied
这是新手最常卡住的第一关。表面看环境装好了，go version 有输出，但一跑 go install 就报类似 mkdir /usr/lib/go/pkg/...: permission denied 的错误。根本原因是 Go 工具链误把系统级目录（GOROOT）当成了用户工作区，试图往里面写文件。
常见诱因：
-
GOPATH没设，或设为空 —— Go 会 fallback 到GOROOT下的pkg目录 -
GOBIN没设，且GOPATH第一个路径下的bin不可写（比如指向了/usr/local/go） - Linux/macOS 下改了
~/.zshrc但没执行source ~/.zshrc，导致新终端里变量仍是空的
GOPATH 还是 Go Modules？新手该选哪个
答案很直接：现在所有新项目都用 Go Modules，GOPATH 只需设一个干净的本地路径（如 $HOME/go），仅用于存放 go install 生成的二进制工具（比如 gopls、delve），不再管项目源码。
关键区别：
立即学习“go语言免费学习笔记（深入）”；
-
GOPATH模式下，所有代码必须放在$GOPATH/src/xxx，否则 import 路径会错 -
Go Modules模式下，项目可放任意路径，靠go.mod文件定位依赖，GOPATH对项目本身已无约束 - VS Code 的 Go 插件默认启用 Modules，如果项目根目录没有
go.mod，它会提示“not in GOPATH”，这不是错误，而是提醒你该初始化模块了
VS Code 里 go 命令找不到或跳转失效
不是插件没装，而是 Go 工具链没被编辑器识别到。VS Code 的 Go 扩展依赖 gopls（Go language server），而 gopls 需要从 GOBIN 或 $GOPATH/bin 加载。如果 GOBIN 没设，又没手动 go install golang.org/x/tools/gopls@latest，插件就只能干瞪眼。
实操建议：
- 先确认
go env GOPATH和go env GOBIN输出是否合理（GOBIN推荐显式设为$GOPATH/bin） - 在项目根目录运行
go mod init example.com/foo生成go.mod - 再执行
go install golang.org/x/tools/gopls@latest—— 它会把gopls放进GOBIN目录 - 重启 VS Code，或按
Ctrl+Shift+P→ “Go: Install/Update Tools”，勾选gopls单独安装
Windows 上 PATH 配置容易漏掉的关键路径
Windows 用户常只加了 %GOROOT%\bin，却忘了 %GOPATH%\bin。结果是 go 命令可用，但 gopls、dlv 等工具找不到，VS Code 提示 “Tool not installed”。
必须确保 PATH 包含这两项（顺序不重要）：
-
%GOROOT%\bin（通常是C:\Go\bin或C:\Program Files\Go\bin） -
%GOPATH%\bin（比如%USERPROFILE%\go\bin）
改完后务必新开一个 CMD/PowerShell，再运行 echo %PATH% 确认生效 —— Windows 不自动刷新已有终端的环境变量。
真正麻烦的不是步骤多，而是每个环节都依赖上一步的变量是否真实生效。建议每配完一项，立刻用 go env 和 echo $PATH（macOS/Linux）或 echo %PATH%（Windows）验证，别攒着一起测。
