应直接安装官方Go二进制包而非系统包管理器，因其版本滞后、GOROOT硬编码导致标准库找不到、ARM64架构不兼容、无法多版本切换；GOROOT须指向解压目录（如/usr/local/go），GOPATH须为用户目录下独立路径（如$HOME/go），二者不可相同；国内必须配置GOPROXY=https://goproxy.cn,direct并验证四步流程（mod init、get、build、run）。
Go 环境搭建本身不难，但新手常因几个关键配置点没处理好，导致后续 go run 报错、go get 卡住、模块初始化失败，甚至误以为 Go 有问题——其实只是环境没对齐。
GOROOT 和 GOPATH 不要手动乱设
Windows 安装 .msi 或 macOS 安装 .pkg 后，GOROOT 通常已自动配置（如 C:\Program Files\Go 或 /usr/local/go），go env 能看到它。除非你解压 tar.gz 手动安装，否则别碰 GOROOT。
GOPATH 在 Go 1.13+ 默认是 $HOME/go，且模块模式（GO111MODULE=on）启用后，它只影响 go install 输出的二进制位置和 go get 下载的旧式依赖缓存，**不是项目根目录**。新手误把项目建在 $GOPATH/src 下，反而容易触发路径冲突或模块识别失败。
- ✅ 正确做法：任意目录新建项目，直接
go mod init example.com/hello - ❌ 错误做法：非得把项目放到
$GOPATH/src/github.com/xxx下再 init - ⚠️ 注意：
go env -w GOPATH=...没必要，除非你要改缓存位置（比如 SSD 空间小，想挪到机械盘）
GO111MODULE 必须显式设为 on
很多教程说“Go 1.13+ 默认开启”，但实际取决于你当前目录是否在 GOPATH 内、是否有 go.mod 文件——这种模糊逻辑会让新手在不同目录下行为不一致，go get 突然报 cannot find module providing package。
立即学习“go语言免费学习笔记（深入）”；
执行这条命令一劳永逸：
go env -w GO111MODULE=on
之后所有项目都走模块模式，go mod init、go mod tidy 才能正常工作，也避免被老式 GOPATH 工作区规则干扰。
- 如果已设过，
go env | grep MODULE应输出GO111MODULE="on" - 若仍出错，检查当前目录是否在
GOPATH子目录里——模块模式下，这反而可能触发降级行为
GOPROXY 不配等于卡死在国内网络
默认 GOPROXY 是 https://proxy.golang.org，国内访问极慢甚至超时，go get 或 go mod download 会卡住几十秒后报错，错误信息像这样：
go: github.com/gorilla/mux@v1.8.0: Get "https://proxy.golang.org/github.com/gorilla/mux/@v/v1.8.0.info": dial tcp 216.58.200.46:443: i/o timeout
推荐配置国内可信代理（支持校验）：
go env -w GOPROXY=https://goproxy.cn,direct
-
goproxy.cn支持go.sum校验，比goproxy.io更可靠 -
,direct表示私有模块（如公司内网域名）绕过代理直连 - 验证：运行
go mod download github.com/spf13/cobra，几秒内完成即生效
PATH 里漏掉 $GOPATH/bin 就找不到 go install 的命令
很多人用 go install 安装工具（比如 gopls、delve），却在终端输 gopls 报 command not found。原因很简单：安装后的二进制默认放在 $GOPATH/bin，但这个路径没加进系统 PATH。
检查方法：
echo $PATH | grep -o "$GOPATH/bin"
如果没输出，就补上：
- macOS/Linux：在
~/.zshrc或~/.bash_profile加一行export PATH=$PATH:$GOPATH/bin - Windows：在系统环境变量
PATH中添加%GOPATH%\bin - 注意：修改后需新开终端或执行
source ~/.zshrc
真正容易被忽略的是：这个路径影响的是「你本地安装的 Go 工具」，不是 Go 编译器本身——go 命令靠 $GOROOT/bin，而 gopls 这类靠 $GOPATH/bin。
