go env -w 是 Go 1.16+ 推荐的环境变量修改方式，安全且仅对当前用户生效；常用命令包括 go env -w GO111MODULE=on、go env -w GOPROXY=https://goproxy.cn,direct 等，执行后可用 go env 验证，用 go env -u 可取消设置。
go env -w 设置环境变量最常用命令
Go 1.16+ 默认启用 Go Modules，go env -w 是修改环境变量的推荐方式，比手动改系统变量更安全、作用域明确（仅对当前用户生效）。
常见组合：
-
go env -w GO111MODULE=on：强制启用模块模式，避免go build在 GOPATH 下误走旧路径 -
go env -w GOPROXY=https://goproxy.cn,direct：国内加速依赖下载，direct表示私有模块直连不走代理 -
go env -w GOSUMDB=off（开发阶段可选）：跳过校验和检查，解决某些内网或私有模块拉取失败问题 -
go env -w GOPATH=$HOME/go：显式指定工作区路径（非必需，但能避免 Windows 上默认在%USERPROFILE%\go造成权限或路径长度问题）
执行后可用 go env 查看是否生效；若想还原某项，用 go env -u GOPROXY 即可。
Windows 下 PATH 配置容易漏掉的点
MSI 安装包通常自动把 C:\Go\bin 加入系统 PATH，但以下情况仍需手动补：
立即学习“go语言免费学习笔记（深入）”；
- 安装时勾选了「Add go to my PATH」但未以管理员身份运行安装程序 → 实际没写入系统变量
- 使用 ZIP 包解压安装（如
go1.25.4.windows-amd64.zip）→ 必须手动将go\bin目录加到 PATH，否则go命令找不到 - PATH 中存在多个 Go 路径（比如旧版本残留）→ 运行
where go确认实际调用的是哪个，避免版本错乱
验证方式不是只看 go version，还要执行 go list -m all，如果报 go: modules disabled，说明 GO111MODULE 没生效或 GOPATH 干扰仍在。
Linux/macOS 修改 shell 配置文件的差异
不同 shell 启动文件不同，改错位置会导致新开终端里 go 命令失效：
- Zsh（macOS Catalina+ 默认）→ 编辑
~/.zshrc，添加export PATH=$PATH:/usr/local/go/bin - Bash（旧版 macOS 或多数 Linux 发行版）→ 改
~/.bash_profile或~/.bashrc，注意.bashrc在非登录 shell 中才加载 - 全局生效（所有用户）→ 修改
/etc/profile，但需 root 权限，且重启终端或执行source /etc/profile
改完必须执行 source ~/.zshrc（或对应文件），否则当前终端不会识别新 PATH；echo $PATH 可确认 /usr/local/go/bin 是否在其中。
GOROOT 和 GOPATH 现在还用不用配？
GOROOT 一般不用手动设：Go 安装后会自动探测，go env GOROOT 能看到值；强行设置反而可能出错（比如指向错误目录导致 go tool 找不到）。
GOPATH 在 Go Modules 主导下已弱化，但仍有影响：
- 未初始化模块的项目（无
go.mod）→ 仍按 GOPATH 规则找代码，容易误建在$GOPATH/src下 -
go install命令默认把可执行文件放进$GOPATH/bin→ 若没设 GOPATH，它会 fallback 到$HOME/go/bin，但该目录未必在 PATH 中 - VS Code 的 Go 插件有时依赖 GOPATH 定位工具 → 设一个干净路径（如
$HOME/go）比让它自动生成更可控
真正关键的是：新建项目一律先 go mod init example.com/myapp，让 Go 明确进入模块模式，此时 GOPATH 就只是存放依赖缓存（pkg）和二进制（bin）的辅助目录，不再决定源码结构。
