go version报错说明path未生效，需重启终端验证；goproxy必须设为https://goproxy.cn,direct并配go111module=on；gopls需手动安装且依赖go.mod初始化。
go version 命令报错或找不到，说明 PATH 没生效
这是 Windows/macOS/Linux 上最常卡住的第一步。不是没装好，而是终端没读到新环境变量。
- Windows：安装
.msi后必须关闭所有 CMD/PowerShell 窗口再重开，否则go不在PATH里 - macOS/Linux：改完
~/.zshrc或~/.bashrc后，一定要执行source ~/.zshrc（注意 shell 类型） - 验证是否真生效：
echo $PATH里得看到/usr/local/go/bin（macOS/Linux）或%GOROOT%\bin（Windows） - 别信“安装完就自动好了”——手动检查比凭感觉靠谱
GOPROXY 不配，go get 会卡死或报 timeout
国内直连 proxy.golang.org 几乎必失败，这不是网络问题，是默认配置问题。
- 必须运行这三行（永久生效）：
go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.org - 别用
https://mirrors.aliyun.com/goproxy/—— 它已停服，返回 404 - 验证：
go env | grep GOPROXY（macOS/Linux）或go env | findstr GOPROXY（Windows）输出应含goproxy.cn - 如果仍拉包失败，
go clean -modcache清掉旧缓存再试
VSCode 插件装了但代码不提示，gopls 启动失败
Go 官方插件依赖 gopls（Go language server），它不会随插件自动安装，且国内常下载失败。
- 先手动触发安装：在 VSCode 中按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Go: Install/Update Tools，勾选gopls后回车 - 若卡在 downloading，关掉 VSCode，终端执行：
GO111MODULE=on GOPROXY=https://goproxy.cn,direct go install golang.org/x/tools/gopls@latest - 检查
gopls是否在PATH里：which gopls（macOS/Linux）或where gopls（Windows） - VSCode 设置里确认
"go.useLanguageServer": true已启用
go run main.go 成功，但 go build 出的二进制无法运行
这不是环境问题，是 Go Modules 和工作目录的隐式约束在起作用。
-
go run可以在任意目录执行单个文件；go build要求当前目录是 module 根（含go.mod） - 新建项目务必先执行：
go mod init example.com/myapp（模块名不用真实域名，能唯一标识就行） - 如果
go.mod里module行写成module .或空，go build会静默失败或生成错误路径的二进制 - 跨平台编译要注意：Windows 上
go build -o myapp.exe才生成可执行后缀；Linux/macOS 默认无后缀
direct、gopls 得手动装、go.mod 得主动初始化——这些点不踩一遍，环境就永远“差不多好了”。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
