Go 1.16+无需配置GOPATH，关键要确保GO111MODULE=on且go mod init的模块路径与import路径严格一致；go version和go run能正常执行即环境已通，其余均为可选优化。
只要 go version 能打出版本号，且 go run main.go 能输出 Hello, World!，就算跑通——其余全是可选优化项。
go version 报错或找不到命令？检查 PATH 和 GOROOT
这是最常见卡点：安装完成但终端里执行 go version 提示 “command not found”。不是没装好，而是系统找不到 go 二进制文件。
- Windows：确认安装时勾选了 “Add Go to PATH”，或手动把
C:\Program Files\Go\bin加进系统环境变量PATH - macOS/Linux：安装 pkg 或 tar.gz 后，
/usr/local/go/bin必须在PATH中；用echo $PATH看是否包含它，没包含就补一句export PATH=$PATH:/usr/local/go/bin到~/.zshrc（M1/M2）或~/.bash_profile（Intel） - 别碰
GOROOT：现代 Go 安装程序会自动设好，除非你手动挪过/usr/local/go，否则不用管它
go run main.go 报 “no required module provides package”？关掉 GOPATH 依赖
Go 1.16+ 默认启用 modules，但如果你还在 $GOPATH/src 下建项目，或者没初始化模块，就会触发这个错误。
- 直接在任意目录（比如
~/helloworld）新建main.go，不要钻进$GOPATH/src - 首次运行前，先执行
go mod init helloworld（模块名随意，但别用main） - 如果已有
go.mod但报错，删掉它再重试go mod init - 不需要设
GOPATH：Go Modules 模式下，GOPATH只影响go install输出位置，跟运行无关
VS Code 里代码不提示、调试失败？只装官方 Go 扩展就够
不是插件越多越好。VS Code 的 Go 插件（golang.go）会自动下载 dlv、gopls 等工具，但国内常因网络中断导致半残。
立即学习“go语言免费学习笔记（深入）”；
- 打开命令面板（
Ctrl+Shift+P），搜 “Go: Install/Update Tools”，全选，点确定 - 重点确认这三项装成功：
gopls（语言服务器）、dlv（调试器）、go（本身） - 如果卡在
gopls，手动执行：GO111MODULE=on GOPROXY=https://goproxy.cn go install golang.org/x/tools/gopls@latest - 重启 VS Code，打开
main.go，右下角状态栏应显示 “Go (gopls)”
跨平台编译失败？GOOS/GOARCH 不是写死的参数
GOOS=linux GOARCH=arm64 go build 看似能出 Linux ARM 可执行文件，但实际可能因依赖 Cgo 或本地库失败。
- 纯 Go 代码（没 import
"C"）才能无条件交叉编译 - 如果用了
net/http、crypto/tls等标准库，Go 会自动适配目标平台，没问题 - 一旦引入 cgo（比如用 sqlite、openssl），就必须在目标平台机器上编译，或配好对应交叉编译链
- 验证是否纯 Go：
go build -ldflags="-s -w" -o hello-linux main.go成功即说明没 cgo 依赖
真正容易被忽略的是模块代理和私有仓库配置——当你开始 go get 第三方包时，GOPROXY 和 GOPRIVATE 才会突然变成阻塞点，而不是现在。
