必须设置go111module=on；goroot通常无需手动设置，go env goroot验证路径有效性；gopath非必需但影响go install输出路径，需确保$gopath/bin在path中；path必须包含$goroot/bin和$gopath/bin，配置后需重载shell并重启ide。
go env 显示的变量哪些真得设
GOROOT 通常不用手动设——Go 安装器（apt、brew、官方 tar.gz）会自动写入，go env GOROOT 输出路径存在且含 src/fmt 和 pkg/tool 就说明没问题。硬设错反而导致 cannot find package "fmt" 或交叉编译失败。
GOPATH 在 Go 1.16+ 模块模式下对依赖管理已失效，但仍有两个实际用途：go install 默认把二进制写进 $GOPATH/bin；部分老 IDE 或脚本仍硬引用它。不设也行，但设了就得确保 $GOPATH/bin 在 PATH 里，否则 gopls、goimports 这类工具命令找不到。
GO111MODULE 必须设为 on。用 auto 容易在没 go.mod 的目录里误入 GOPATH 模式，引发 no required module provides package 错误。验证方式：运行 go env GO111MODULE，输出必须是 on。
PATH 配错是 go 命令报 “command not found” 的主因
PATH 必须包含两个路径：
-
$GOROOT/bin（运行go命令本身） -
$GOPATH/bin或你自定义的$GOBIN（运行go install安装的工具）
Linux/macOS：追加到 ~/.zshrc 或 ~/.bashrc 末尾：
export PATH="$GOROOT/bin:$GOPATH/bin:$PATH"
Windows：必须通过“系统属性 → 高级 → 环境变量”图形界面设置，Path 变量里加两行：
%GOROOT%\bin%GOPATH%\bin
注意：; 是唯一合法分隔符，不能混入中文顿号、换行或空格；PowerShell 临时 $env:Path += 不生效，IDE 启动的子进程读不到。
IDE 启动后 go env 显示空值怎么办
VS Code 图形图标启动时默认不加载 shell 配置（如 ~/.zshrc），GOROOT 和 GO111MODULE 就会为空。解决方法分三类：
- macOS：终端执行
code .启动 VS Code，继承当前 shell 环境 - Windows：用管理员权限打开 PowerShell，再运行
& "C:\Program Files\JetBrains\GoLand\bin\goland64.exe" - 通用：在项目根目录
.vscode/settings.json里显式指定："go.goroot": "/usr/local/go"（路径按实际改）
关键验证动作：打开 VS Code 内置终端，直接运行 go env GOROOT GO111MODULE，别只信设置界面里的提示。
go install 的命令为啥敲不响
不是环境变量没设对，而是输出路径和 PATH 没对上：
- 默认
go install把二进制写进$GOPATH/bin，所以你得确认该路径确实在PATH中 - 想换个位置？先设
GOBIN=/opt/go-tools，再把/opt/go-tools加进PATH - PATH 顺序很重要：如果系统已有同名命令（比如
/usr/bin/goimports），而你的$GOPATH/bin/goimports在 PATH 里靠后，就会优先调用旧版
执行 which goimports（Linux/macOS）或 where goimports（Windows）能立刻暴露路径冲突问题。
真正容易被忽略的是：环境变量配置完，必须新开终端或重载 shell（source ~/.zshrc），且 IDE 要重启——很多问题其实卡在这一步，而不是变量本身设错了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
