Go环境配置关键在于三个开关：GO111MODULE必须为on且生效，gopls需成功启动并配置GOPROXY，CGO_ENABLED=0必须显式设置以实现静态编译，GOROOT和GOPATH保持默认即可。
go version 能跑出来，不代表环境就配对了。很多新手卡在“能编译但无法调试”“依赖下载失败”“IDE补全不工作”这些环节，本质不是不会装 Go，而是没抓住几个关键开关。
确认 GO111MODULE=on 是不是真生效
Go 1.16+ 默认启用 Modules，但 go env -w GO111MODULE=on 只写进用户级配置，某些 shell（比如 zsh 的非登录 shell）或 IDE 启动方式可能读不到。常见现象是：终端里 go mod init 正常，但在 VS Code 里新建项目却提示 “cannot find module providing package”，或者 go get 报错 “go: modules disabled”。
实操建议：
• 运行 go env GO111MODULE，输出必须是 on，不是空或 auto
• 如果是 auto，说明没真正写入，再执行一次 go env -w GO111MODULE=on，并重启终端/IDE
• 在项目根目录下检查是否存在 go.mod 文件——没有它，Modules 就没真正激活
VS Code 里 gopls 没起来，补全和跳转就废了一半
VS Code 的 Go 扩展靠 gopls（Go language server）提供语义分析、类型推导和自动补全。它不是装完插件就自动可用的，尤其在国内网络环境下，首次加载容易卡住或静默失败。
实操建议：
• 打开一个 .go 文件后，看右下角状态栏有没有 gopls 进度条或 “Loading…” 提示
• 如果一直不动，手动触发：Ctrl+Shift+P → 输入 “Go: Install/Update Tools” → 勾选 gopls → 点 Install
• 若提示 “proxy.golang.org:443: timeout”，需提前配好代理或国内镜像：go env -w GOPROXY=https://goproxy.cn,direct
• 验证是否生效：在 main.go 里输入 fmt.，应立刻弹出 Println 等函数列表
交叉编译时 CGO_ENABLED=0 不加，静态二进制就白做了
很多人想打包一个纯静态可执行文件丢进 Alpine 容器，结果运行时报错 standard_init_linux.go:228: exec user process caused: no such file or directory。这不是路径问题，而是默认启用了 CGO，链接了 libc 动态库，而 Alpine 用的是 musl libc。
实操建议：
• 构建命令必须显式禁用 CGO：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o server .
• 不要只设 GOOS 和 GOARCH，漏掉 CGO_ENABLED=0 就等于没做静态编译
• 验证是否成功：用 file server 查看输出，应含 statically linked；用 ldd server 应提示 not a dynamic executable
GOROOT 和 GOPATH 现在到底要不要碰
新版 Go（1.16+）对这两个变量的态度很明确：GOROOT 几乎不用改，GOPATH 也不再决定项目位置。但很多人仍纠结该不该清空 GOPATH 或手动设置它，导致工具安装失败（比如 dlv 找不到）、go install 命令失效。
实操建议：
• GOROOT：由安装程序自动设好，运行 go env GOROOT 看路径是否指向你的 Go 安装目录（如 /usr/local/go），别动它
• GOPATH：现在只用于存放全局工具（go install 安装的二进制）和模块缓存，保持默认即可（通常是 $HOME/go）
• 不要为了“整洁”删掉 $HOME/go/bin，否则 dlv、gofumpt 这些工具就找不到
• 如果你用 go install 安装工具，确保 $HOME/go/bin 在系统 PATH 里（Mac/Linux 检查 ~/.zshrc 或 ~/.bash_profile；Windows 检查系统环境变量）
立即学习“go语言免费学习笔记（深入）”；
真正卡人的点不在“装不装得上”，而在“哪些开关看似默认，实则需要手动拍死”。比如GO111MODULE 开关、gopls 加载状态、CGO_ENABLED 是否为 0 —— 这三个地方一松手，后面所有开发体验都会打折。 
