环境变量不生效的主因是go进程未继承配置，而非配置错误；需确保终端重载、path顺序正确、gui工具显式启动，并在对应层级（shell、ide、docker）显式注入变量。
环境变量不生效，90% 是因为没让 Go 进程真正继承到——不是配置错了，是路径没走通。
go env 显示的 GOROOT/GOPATH 不是你设的？先看终端是否重载了环境
Windows 上改完「系统属性 → 环境变量」后，CMD 或 PowerShell 必须完全关闭再重开；VS Code 内置终端也得关掉整个窗口（不是只关终端标签页）。否则它还在用旧进程快照。
- 验证方式：在新终端里执行
echo %GOROOT%（Windows）或echo $GOROOT（macOS/Linux），确认输出是你设的路径 - 如果
go env里 GOROOT 正确但 GOPATH 仍是默认值（如C:\Users\xxx\go），说明 Go 1.8+ 自动 fallback 了——你没显式设置 GOPATH，或设置了但被后续 PATH 中其他 go 覆盖 - 运行
where go（Windows）或which go（macOS/Linux），比对输出路径和$GOROOT\bin\go是否一致
Linux/macOS 下配置永久生效：别只改 ~/.bashrc
你当前 shell 是 zsh（macOS Catalina+ 默认）还是 bash，决定了该改哪个文件。执行 echo $SHELL 看清楚，别凭印象乱改。
- zsh 用户必须改
~/.zshrc，bash 用户改~/.bashrc或~/.profile（后者更全局） - 追加内容要包含三部分：
export GOROOT=/usr/local/go、export GOPATH=$HOME/go、export PATH=$GOROOT/bin:$GOPATH/bin:$PATH - 改完立刻生效：运行
source ~/.zshrc（或对应文件），别等重启 - 注意顺序：
$GOROOT/bin必须在$PATH前面，否则多个 Go 版本共存时会调错
VS Code 启动后环境变量丢失？别靠双击图标
Mac/Linux 下双击 VS Code 图标启动，它不读 shell 配置文件；Windows 下若只在 CMD 里 set GOPATH=...，VS Code 进程根本看不到。
- Mac/Linux：一律用终端启动，例如
code --no-sandbox（确保当前 shell 已source过配置） - Windows：必须通过「系统属性 → 环境变量」设置用户级变量，并把
%GOROOT%\bin和%GOPATH%\bin显式加进PATH - 验证：在 VS Code 内置终端执行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），搜go看路径是否在里面 - 插件安装失败（如
goplsnot found）时，先检查go env -w GOPROXY=...是否带direct，否则私有模块会卡住
Go 程序里 os.Getenv 读不到变量？不是代码问题，是传入链断了
os.Getenv 返回空，大概率是变量压根没进进程。IDE 直接点运行、Docker 未 -e、CI 未声明 env，都会导致这个现象。
- 临时调试：Linux/macOS 用
FOO=bar go run main.go；Windows CMD 用set FOO=bar && go run main.go - 生产部署：Dockerfile 里写
ENV FOO=bar，Kubernetes yaml 里用env:字段，别指望容器自动继承宿主机变量 - 测试时别用
FOO=bar go test管道命令——变量只传给第一个go list，后面的go test子进程收不到；改用godotenv -f .env go test或export FOO=bar && go list | xargs -I{} sh -c 'FOO=$FOO go test {}' - 永远用
os.LookupEnv替代os.Getenv，它返回(value string, ok bool)，能区分「变量不存在」和「值为空」
最常被忽略的点：环境变量作用域是分层的——shell 配置只影响它启动的子进程，GUI 应用（如 VS Code、Goland）通常不继承，而 Docker 容器默认隔离。想让它生效，就得在对应层级显式注入，没有“一劳永逸”的写法。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
