必须设置 goroot、gobin 和 path；goroot 指向 go 安装根目录，gobin 设为 $goroot/bin 并加入 path；go111module 推荐设为 on；gopath 在模块模式下非必需但旧项目仍需；ide 需确保继承 shell 环境或手动配置。
Go 语言环境不是装完 go 命令就万事大吉——没配对 GOPATH 和 GOROOT，go mod 会报错；没关掉 GO111MODULE 自动模式，老项目可能直接构建失败；CGO_ENABLED=0 看似省事，但用了 cgo 的库（比如 net DNS 解析）会静默降级或 panic。
确认系统已安装 Go 并验证版本兼容性
别只看 go version 输出的数字，重点看是否含 linux/amd64 这类平台标识，以及是否为官方二进制（非 snap 或包管理器打包版）。Ubuntu/Debian 用 apt 装的 golang-go 包常滞后 2~3 个 minor 版本，且 GOROOT 路径不标准，容易和手动安装冲突。
- 运行
which go，输出应为/usr/local/go/bin/go或你解压的路径，而非/usr/bin/go - 检查
go env GOROOT，必须指向 Go 安装根目录（如/usr/local/go），不能是空或$HOME/sdk/go这类错误路径 - 若用
go install安装工具（如gopls），需确保GOBIN已设且在$PATH中，否则命令找不到
设置 GOPATH 和模块初始化开关
GOPATH 在 Go 1.16+ 不再影响模块行为，但它仍控制 go get 下载依赖的位置、go install 编译产物存放路径，以及 go list -m all 的默认工作区。很多 CI 脚本和 IDE 插件（如 VS Code 的 Go 扩展）仍会读取它。
- 推荐显式设置：
export GOPATH=$HOME/go，并把$GOPATH/bin加入$PATH -
GO111MODULE默认值是auto，这意味着：在GOPATH外且含go.mod的目录下启用模块，在GOPATH/src下却强制禁用——老项目迁移时极易踩坑 - 统一设为
on：export GO111MODULE=on，避免路径依赖导致行为不一致
编译参数优化：何时该用 CGO_ENABLED=0
CGO_ENABLED=0 生成纯静态二进制，适合容器部署，但代价是放弃 cgo 提供的系统能力。最典型问题是：DNS 解析退化为纯 Go 实现（netdns=cgo 失效），导致 lookup 超时或返回空结果；os/user.LookupUser 直接 panic。
- 仅当项目完全不调用
C库（即不用net、os/user、os/signal等依赖系统调用的包）时才设CGO_ENABLED=0 - 容器镜像中若需解析域名，保留
CGO_ENABLED=1，并确保基础镜像含libc（如debian:slim可用，scratch不行） - 交叉编译时（如 macOS 编译 Linux 二进制），
CGO_ENABLED=0是唯一选择，否则会报cannot use cgo when cross-compiling
IDE 和调试支持的关键配置项
VS Code 的 gopls 默认从 go env 读配置，但某些字段（如 GOPROXY）被 IDE 缓存后不会自动刷新，改完环境变量要重启窗口。
-
GOPROXY推荐设为https://proxy.golang.org,direct，国内可加https://goproxy.cn备用，避免因网络波动导致go mod download卡死 -
GOSUMDB设为sum.golang.org（默认），不要关掉，否则go get可能因校验失败拒绝安装依赖 - 调试时若看到
could not launch process: fork/exec ... no such file or directory，大概率是dlv未安装或不在$PATH，运行go install github.com/go-delve/delve/cmd/dlv@latest补齐
环境变量不是设完就生效的黑盒——go env -w 写入的是用户级配置，但 shell 启动时加载的 .bashrc 或 .zshrc 里若重复 export，会覆盖前者；Docker 构建时 ENV 指令顺序也影响最终值。调不通时，先 go env 和 env | grep GO 对着看两遍。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
