根本原因是path未正确配置go的bin目录，而非go未安装；macos/linux需确认$goroot/bin在path中并从终端启动code，windows需将c:\go\bin加入系统path并重启终端验证。
go version 报错、VSCode 插件不工作——90% 是环境变量或工具链没配对，不是 Go 本身的问题。
go command not found 或 go version 报错
这是最常见也最容易被误判的问题。根本原因不是 Go 没装好，而是 PATH 没把 Go 的二进制目录加进去。
- macOS / Linux：检查
$GOROOT/bin是否在PATH中，比如/usr/local/go/bin（Homebrew 默认）或/opt/homebrew/opt/go/libexec/bin（Apple Silicon） - Windows：安装时务必勾选
Add Go to PATH；若手动安装，需把C:\Go\bin加到系统环境变量PATH，而不是用户变量（尤其用管理员权限运行 VSCode 时） - 验证方式：终端里执行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认输出里包含 Go 的bin路径 - 改完环境变量后，重启终端（不是关掉再开一个窗口，是彻底关闭再重开），否则 shell 不会 reload
VSCode Go 插件提示 “gopls not found” 或无法跳转
gopls 是 Go 官方语言服务器，不是插件自带的，必须单独安装。VSCode 插件只负责调用它。
- 不要点“忽略”，也不要手动下载二进制——用命令面板执行
Go: Install/Update Tools，全选（至少勾上gopls、dlv、goimports） - 如果卡住或报
cannot find package，大概率是代理问题：运行go env -w GOPROXY=https://goproxy.cn,direct（国内）或go env -w GOPROXY=https://proxy.golang.org,direct（海外） - 确保
GO111MODULE=on（现代项目必须开启模块），可执行go env -w GO111MODULE=on - 安装完成后，重启 VSCode，打开一个
.go文件，看右下角状态栏是否显示 “gopls” 正在运行
go build 失败但本地能跑，Docker 构建报 CGO 错误
本地 macOS 或 Windows 上默认启用 CGO_ENABLED=1，但 Linux 容器镜像常缺 libc 开发头文件，一编译就挂。
- 绝大多数纯 Go 项目不需要 cgo，直接禁用：
CGO_ENABLED=0 go build -o myapp main.go - 如果用了
sqlite、net包里的 DNS 解析等依赖 cgo 的功能，就得保留 CGO，但要确保基础镜像含libc-dev（如golang:1.21-bookworm），而不是精简版scratch或alpine - 别信网上“
go build -a就能解决”的说法——-a已废弃，且不解决动态链接缺失问题 - CI/CD 中建议固定构建环境变量，比如在 GitHub Actions 或 GitLab CI 里显式写
CGO_ENABLED: "0"
GOPATH 还要不要设？设在哪？
Go 1.16+ 默认开启 module 模式，GOPATH 不再决定项目位置，但它仍影响 go install 生成的二进制存放路径和第三方工具（如 gopls）的缓存位置。
- 不必刻意设
GOPATH，Go 会默认用$HOME/go（macOS/Linux）或%USERPROFILE%\go（Windows） - 如果想自定义（比如 SSD 空间小，想放 NAS），用
go env -w GOPATH=/path/to/your/go即可，无需手动 export - 切记：不要把项目源码放在
$GOPATH/src下——那是旧模式逻辑，现在项目可任意路径，靠go.mod识别 - 真正需要关注的是
GOBIN：它控制go install输出位置，如果你希望所有工具统一放在某个 bin 目录，设它比改GOPATH更直接
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
