go version无响应需先检查PATH是否包含Go的bin目录；必须执行go env -w GO111MODULE=on和go env -w GOPROXY=https://goproxy.cn,direct；跨平台编译须设CGO_ENABLED=0；VS Code工具下载失败应核查GOPROXY与GOROOT。
go version 命令没反应？先确认 PATH 是否包含 go 的 bin 目录
安装后执行 go version 报 “不是内部或外部命令”，本质是系统找不到 go 可执行文件。Windows 的 .msi 安装包默认会把 C:\Go\bin（或你自定义的安装路径下的 \bin）加进系统 PATH，但有三个常见断点：
- 安装时改了路径（比如装到
D:\Go），但没手动补D:\Go\bin到PATH - 安装完没关掉已打开的 CMD/PowerShell —— 环境变量不会自动刷新旧终端
- 某些企业策略禁用了自动写入
PATH，哪怕选了默认路径也得手配
验证方式：在新打开的终端里运行 echo %PATH%（Windows）或 echo $PATH（macOS/Linux），看输出里有没有 Go 对应的 bin 路径。没有就补上，别依赖“应该自动配好了”。
go env -w GO111MODULE=on 是必须的，不是可选项
Go 1.16+ 虽然默认启用模块模式，但部分旧项目或跨平台构建脚本仍可能因环境变量未显式设置而 fallback 到 GOPATH 模式，导致 go build 找不到依赖或生成错误的 vendor 行为。尤其在 CI/CD 或 Docker 构建中，这个变量缺失会直接失败。
-
go env -w GO111MODULE=on强制全局启用模块管理，绕过GOPATH限制 - 搭配
go env -w GOPROXY=https://goproxy.cn,direct，解决国内拉包超时问题 - 不要用
set GO111MODULE=on（Windows CMD 临时变量），它只在当前终端生效，CI 脚本一跑就失效
跨平台编译前必须关掉 CGO，否则 GOOS/GOARCH 无效
想用 macOS 编译出 Windows 可执行文件？或者 Linux 上编译 ARM64 二进制？直接设 GOOS=windows GOARCH=amd64 go build 很大概率报错：cannot use cgo for cross compilation。根本原因是 CGO 默认开启，而 C 语言部分无法跨平台链接。
立即学习“go语言免费学习笔记（深入）”；
- 编译前必须加
CGO_ENABLED=0，例如：CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o app-linux-arm64 . - 如果项目真依赖 C 库（如 SQLite、OpenSSL），就不能纯静态跨编译，得用对应平台的交叉编译工具链，复杂度陡增
-
CGO_ENABLED=0同时会让二进制完全静态链接，不依赖目标系统 libc，适合容器部署
VS Code 中 go 工具链下载失败？重点查 GOPROXY 和 GOROOT
VS Code 的 Go 插件（Go by Google）启动时会自动下载 dlv（调试器）、gopls（语言服务器）等工具。国内用户常卡在 “Installing tools…” 步骤，错误日志里反复出现 timeout 或 no matching versions。
- 先确认
go env GOPROXY输出是https://goproxy.cn,direct，不是空或https://proxy.golang.org - 检查
GOROOT是否指向真实安装路径（比如C:\Go），插件会从这里读取go版本并决定该下哪个版本的gopls - 如果插件仍失败，手动下载：访问 https://www.php.cn/link/37e573e3be876183d1dc407734b0c16f 找对应
gopls版本，解压后把二进制丢进$GOPATH/bin，再重启 VS Code
跨平台编译真正难的不是命令怎么写，而是搞清 CGO 和模块代理这两层隐性开关 —— 它们不报错，但会让结果和预期差很远。
