go 1.21+ 环境需显式配置 go111module=on 和 goproxy=https://goproxy.cn,direct，否则 go mod download 会卡死或报错；gobin 与 path 必须一致，且需验证代理生效、模块初始化后立即测试依赖拉取。
直接装好就能写代码，不用反复折腾环境变量或代理——这是2026年标准 Go 环境的底线。新版 Go（1.21+）默认启用模块模式，GOPATH 不再强制设置，但 GOPROXY 和 GO111MODULE 必须显式配对生效，否则 go mod download 会卡死或报 no required module provides package。
验证 go version 能跑，不等于环境就 ready
很多用户执行 go version 成功后就以为万事大吉，结果一跑 go mod init 就报错，或者 go run main.go 提示找不到包。根本原因在于：Go 工具链启动时只检查 GOROOT 和 PATH，但模块行为由另外两个变量控制：
-
GO111MODULE=on：强制启用模块模式（Go 1.16+ 默认 auto，但 auto 在非模块目录下会退化为 GOPATH 模式，行为不可靠） -
GOPROXY=https://goproxy.cn,direct：国内必须设，否则go get会直连 golang.org/x/…，超时或 403 - 没设
GOBIN时，go install生成的二进制默认落在$GOPATH/bin，而这个路径若没加进PATH，命令就找不到
Windows 上最简可靠的环境变量配置
不要依赖安装程序自动设的变量，尤其当你是从旧版升级或重装过系统。手动在 PowerShell 中运行以下命令（永久生效）：
go env -w GO111MODULE=on go env -w GOPROXY=https://goproxy.cn,direct go env -w GOBIN=$HOME\go\bin $env:PATH += ";$env:USERPROFILE\go\bin"
注意：$HOME\go\bin 是推荐路径，不是必须；但 GOBIN 和 PATH 必须一致，否则 go install 出的命令无法在终端直接调用。
macOS / Linux 下 PATH 和 shell 配置容易漏的点
Homebrew 安装的 Go（路径在 /usr/local/Cellar/go/x.x.x/libexec）不会自动设 GOROOT，导致某些工具（如 Delve 调试器）初始化失败。必须补上：
echo 'export GOROOT=$(brew --prefix go)/libexec' >> ~/.zshrc echo 'export PATH=$GOROOT/bin:$PATH' >> ~/.zshrc source ~/.zshrc
同时确认 ~/.zshrc 确实被加载（echo $SHELL 是 /bin/zsh 且未被 ~/.zprofile 覆盖）。如果用的是 M1/M2 Mac，别选错安装包：darwin-arm64.pkg 对应 Apple Silicon，选成 darwin-amd64.pkg 会导致 go build 报 cannot execute binary file。
go mod init 后立刻验证依赖是否真能拉下来
初始化模块只是生成空 go.mod，不代表网络通、代理活、权限对。执行完 go mod init myapp 后，马上试一句：
go get github.com/gin-gonic/gin@v1.9.1
如果卡在 Fetching 或报 invalid version，八成是 GOPROXY 没生效（用 go env GOPROXY 确认），或是公司内网拦截了 .cn 域名——此时换 https://mirrors.aliyun.com/goproxy/ 或临时加 ,direct 到末尾兜底。
真正麻烦的不是装不上，而是装上了却默认走错路径、用错代理、或 shell 配置没 reload —— 这些地方不显眼，但会让后续所有 go run、go test、go generate 行为变得不可预测。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
