Go环境真正就绪需满足三条件：go version能正确输出当前版本、go mod download能秒下依赖、go build无明显卡顿；任一不满足即说明配置存在问题，如PATH与GOROOT冲突、GOPROXY未配置或CGO影响编译性能。
Go 环境装得对不对，不看教程步骤，只看 go version 能不能跑、go mod download 能不能秒下、go build 编译有没有明显卡顿——三者全通才算真正就绪。
go version 报错或显示旧版本？先查 GOROOT 和 PATH 是否冲突
常见现象：go version 报 command not found，或输出 go1.16.7 这类明显过时的版本（当前稳定版已是 go1.22.x），说明系统里存在多个 Go 安装路径，shell 优先加载了旧版本。
- 执行
which go查真实调用路径，再对比echo $GOROOT和go env GOROOT是否一致 - Linux/macOS：检查
/etc/profile、~/.bashrc、~/.zshrc里是否有多处export PATH=...拼接，尤其注意是否把旧版/usr/bin或/usr/local/go-old/bin放在了新版路径前面 - macOS 若用 Homebrew 安装过又手动装了 .pkg，
brew unlink go再重设PATH更稳妥 - Windows 用户重点检查「系统变量」和「用户变量」里是否都写了
%GOROOT%\bin，且GOROOT值指向实际安装目录（如C:\Go）
go mod download 卡在 golang.org/x/？必须配 GOPROXY
不是“建议”配代理，是没配就根本没法用——国内网络下，go mod download 默认直连 golang.org 会超时或 404，错误信息常为 could not determine kind of import path 或 Get "https://proxy.golang.org/...": dial tcp: i/o timeout。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://mirrors.aliyun.com/goproxy/ - 同时加
go env -w GOSUMDB=sum.golang.google.cn，否则go get会因校验失败中断 - 验证是否生效：运行
go env | grep -E "(GOPROXY|GOSUMDB)"，输出应为明确值，而非空或off - 若公司内网禁外网，需自建
athens或goproxy服务，并把GOPROXY设为内网地址（如http://proxy.internal:8080）
go build 编译慢？别只怪 CPU，先关掉 CGO 和调试符号
默认 go build 生成的二进制含 DWARF 调试信息、链接 libc、启用 cgo，体积大、启动慢、编译耗时长。生产部署前必须优化。
立即学习“go语言免费学习笔记（深入）”；
- 禁用调试信息：
go build -ldflags="-s -w" main.go（-s去符号表，-w去 DWARF） - 强制静态链接（避免依赖系统 libc）：
CGO_ENABLED=0 go build -a -ldflags="-s -w" main.go - 交叉编译无需本地环境：
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -ldflags="-s -w" -o app-linux main.go - 注意：若项目用了
net包的 DNS 解析（如net/http），CGO_ENABLED=0下会回退到纯 Go 实现，性能略降但更可控；若必须用系统 resolver，保留CGO_ENABLED=1并指定libc版本
VSCode 里 go run 不生效？gopls 启动失败是主因
VSCode 的 Go 插件依赖 gopls 提供语言服务，它启动失败会导致代码跳转、自动补全、保存格式化全部失效，但界面无明显报错，容易误判为配置问题。
- 打开 VSCode 命令面板（
Cmd+Shift+P/Ctrl+Shift+P），执行Go: Install/Update Tools，勾选gopls单独安装 - 检查
gopls日志：在 VSCode 设置中搜go.gopls.logLevel，设为verbose，重启后看输出面板里的Go (gopls)标签页 - 常见根因：
GOPROXY未生效导致gopls自动下载依赖失败；或GOROOT路径含空格/中文（Windows 尤其敏感） - 临时绕过：在项目根目录建
.vscode/settings.json，写入{"go.toolsEnvVars": {"GOPROXY": "https://goproxy.cn,direct"}}，强制继承代理
真正卡住的从来不是安装步骤，而是 go env 输出里那些看似无关的字段——比如 GOPATH 为空却还在用 src 目录结构，或者 GO111MODULE 是 auto 却没 go.mod 文件。这些细节不显眼，但会让后续所有操作无声失效。
