go环境配置核心是确保go version能执行、go111module=on、goproxy配好国内镜像、path包含$goroot/bin；goroot通常自动设置无需改动，gopath可自定义但需将$gopath/bin加入path，windows须用图形界面配置避免分隔符错误。
Windows/macOS/Linux 上装 Go，只要 go version 能输出版本号，环境就算通了；但真正写项目时卡住的，90% 是 GOPROXY 没配、GO111MODULE 没开、或 PATH 漏了 GOROOT/bin —— 这些不是“可选配置”，是默认必须设对的。
go version 报错或找不到命令？检查 PATH 里有没有 GOROOT/bin
安装完 .msi（Windows）或 .pkg（macOS）后，系统通常会自动加 GOROOT/bin 到 PATH，但有三个常见断点：
- 安装完没关掉所有 CMD/PowerShell 窗口，旧终端不读新环境变量
- 手动解压
.tar.gz（Linux/macOS）后只设置了GOROOT，忘了把$GOROOT/bin加进PATH - Windows 用户改过安装路径（比如装到
D:\golang），但PATH里还留着默认的C:\Program Files\Go\bin
验证方法：运行 echo %PATH%（Windows）或 echo $PATH（macOS/Linux），确认输出中包含你实际的 GOROOT 下的 bin 路径。如果缺失，就补上——别依赖“安装包说它配好了”。
go env 显示 GOPATH 是 C:\Users\xxx\go，但我想放 D 盘？可以改，但别乱动 GOROOT
GOROOT 是 Go 安装目录，指向标准库和编译器，**不要手动修改它**（除非你真换地方重装了 Go）。而 GOPATH 是你的工作区，默认值只是建议，完全可以按需调整：
- Windows：在“系统属性 → 环境变量”里，改用户变量
GOPATH的值为D:\mygopath，再确保%GOPATH%\bin也在PATH中 - macOS/Linux：在
~/.zshrc或~/.bash_profile里改export GOPATH=$HOME/go为export GOPATH=/Volumes/Data/go，然后source ~/.zshrc - 注意：
go mod项目不需要GOPATH存代码，但go install编译的二进制仍会放进$GOPATH/bin，所以这个路径最好保持可写且空间充足
go get 失败、timeout、module lookup failed？立刻配 GOPROXY 和 GO111MODULE
Go 1.16+ 默认开启模块模式，但国内不配代理基本无法拉包。执行这三条命令（一次就好，永久生效）：
go env -w GO111MODULE=on go env -w GOPROXY=https://goproxy.cn,direct go env -w GOSUMDB=sum.golang.org
关键点：
-
GO111MODULE=on强制启用模块，避免陷入GOPATH旧模式歧义 -
GOPROXY=https://goproxy.cn,direct表示优先走七牛镜像，找不到时才回源官方（direct不可省） -
GOSUMDB=sum.golang.org保持校验，别设成off，否则go get可能拒绝安装 - 验证是否生效：
go env | findstr GOPROXY（Windows）或go env | grep GOPROXY（macOS/Linux）
go run main.go 成功，但 go install 报错 exec: "gcc" not found？那是 CGO 问题，和环境变量无关
这个错误和 GOROOT/GOPATH 配置完全无关，是 Go 尝试调用 C 编译器编译 CGO 代码失败。常见于：
- Windows：没装 TDM-GCC 或 MinGW-w64，或没加到
PATH - macOS：Xcode 命令行工具没装（
xcode-select --install） - Linux：没装
build-essential（Ubuntu/Debian）或gcc（CentOS/RHEL）
如果你写的纯 Go 项目（没 import "C"），可以临时绕过：CGO_ENABLED=0 go install。但长期建议把 C 工具链配齐，很多标准库（如 net）在某些平台依赖 CGO。
最常被跳过的其实是 go env -w GOPROXY 这一步——很多人试了 go version 和 go env 都通了，就以为万事大吉，结果第一次 go get 就卡死十分钟，还以为网络或 Go 本身坏了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
