GOROOT必须指向Go SDK根目录（含src、pkg、bin），而非bin子目录；GOPATH默认为$HOME/go或%USERPROFILE%\go，修改需谨慎；PATH必须同时包含$GOROOT/bin和$GOPATH/bin，且不可覆盖原有路径。
GOROOT 必须指向安装根目录，不是 bin 子目录
GOROOT 错误最常见的是设成 /usr/local/go/bin 或 C:\Go\bin——这会导致 go version 直接报错或命令根本启动不了。它必须是 Go SDK 的根目录，里面得有 src、pkg、bin 三个子目录。
验证方式很简单：go env GOROOT 输出的路径，应该能直接 ls 到 bin/go 和 src/runtime。如果输出为空或路径下没有这些内容，说明 GOROOT 没设对，或者根本没生效。
- macOS/Linux 官方 pkg 安装默认是
/usr/local/go；手动解压一般放在~/sdk/go1.23.0这类路径 - Windows msi 安装通常是
C:\Go；zip 解压建议用不含空格和中文的路径，比如C:\go123 - 别用软链接路径（如
/opt/go → /home/user/sdk/go1.23），某些 shell 或旧版 Windows cmd 无法正确解析
GOPATH 默认值够用，改之前先想清楚要不要动
Go 1.8+ 默认 GOPATH 就是 $HOME/go（Linux/macOS）或 %USERPROFILE%\go（Windows）。除非你有明确需求，否则不建议改——比如：需要把工作区放在 SSD 外的机械盘、公司策略要求统一路径、或要隔离多个团队项目。
改了之后，所有 go install 装的工具（如 dlv、gopls）都会落到 $GOPATH/bin，而这个目录必须加进 PATH 才能直接运行。漏掉这步，就会出现 command not found。
立即学习“go语言免费学习笔记（深入）”；
- 多路径写法（
GOPATH=path1:path2）是过时误传，Go 不支持，设了也只认第一个 - 路径里不能含空格、中文、括号或特殊符号（如
My Projects、我的go），Windows 下尤其容易出问题 - 即使启用 Go Modules（
GO111MODULE=on），go install仍依赖 GOPATH，所以它没被废弃，只是角色变了
PATH 必须同时包含 $GOROOT/bin 和 $GOPATH/bin
只加 $GOROOT/bin 只能运行 go 命令本身；漏掉 $GOPATH/bin，你就没法在终端里直接敲 gofmt 或自己 go install 的命令。
写法上最容易踩坑的是覆盖 PATH：export PATH="$GOROOT/bin" 会清掉系统原有路径，导致 ls、cd 都失效。正确写法一定是 export PATH="$PATH:$GOROOT/bin:$GOPATH/bin"。
- Linux/macOS：写进
~/.zshrc（zsh 默认）或~/.bashrc（bash 用户），然后source ~/.zshrc - Windows PowerShell：别用
$env:PATH += "..."，那是临时的；改$PROFILE或用「系统属性 → 环境变量」图形界面 - Windows CMD：必须用图形界面配置，命令行
set PATH=...只对当前窗口有效
go env -w 不能替代系统 PATH 设置
有人试过 go env -w GOPATH=/data/go 就以为万事大吉，结果 dlv 还是找不到——因为 go env -w 只改 Go 工具链内部读取的环境变量，完全不碰 Shell 的 PATH。它甚至不负责让系统知道 /data/go/bin 在哪。
真正影响命令能否执行的，永远是 Shell 启动时读到的 PATH 值。你可以用 echo $PATH（Linux/macOS）或 echo %PATH%（Windows CMD）确认是否包含目标路径。
-
go env GOPATH和echo $GOPATH输出可能不一致：前者是 Go 工具链看到的，后者才是 PATH 查找时实际用的 - 如果设了
GOBIN（比如go env -w GOBIN=/opt/mybin），记得把这个自定义路径也加进PATH，而不是指望go env -w自动搞定 - 每次改完 PATH，一定要新开终端验证，旧终端不会自动更新
