Go命令未识别说明PATH未生效，需重启终端或正确配置shell配置文件；go mod init失败主因是GOPROXY未设为国内镜像；VS Code无提示需手动安装gopls和dlv；go build闪退多因CGO启用导致DLL依赖，可设CGO_ENABLED=0静态编译。
go version 命令报错或不识别
说明 go 命令根本没进系统 PATH，不是“装了但没配好”，而是环境变量压根没生效。Windows 安装 .msi 后必须重启 CMD/PowerShell；Linux/macOS 执行完 source ~/.bashrc 或 source ~/.zshrc 后，还得确认 shell 类型是否匹配（比如 macOS Catalina 及之后默认用 zsh，改 .bashrc 没用）。
常见错误现象：'go' is not recognized as an internal or external command（Windows）或 command not found: go（macOS/Linux）。
验证方式：直接运行 echo $PATH，看输出里有没有 /usr/local/go/bin（macOS/Linux）或 C:\Program Files\Go\bin（Windows）。
实操建议：
• Windows 用户安装完立刻关掉所有终端再重开
• macOS 用户优先检查 echo $SHELL，再决定改 .zshrc 还是 .bash_profile
• Linux 用户别漏掉 sudo 权限解压，否则 /usr/local/go 目录可能权限不足
go mod init 失败或依赖拉取超时
Go 1.16+ 默认启用模块模式，但国内直连 proxy.golang.org 几乎必失败。不设代理，go mod tidy 会卡住甚至报 Get "https://proxy.golang.org/..." dial tcp: i/o timeout。
必须手动配置三项：
• go env -w GO111MODULE=on（确保模块强制启用）
• go env -w GOPROXY=https://goproxy.cn,direct（七牛云镜像，稳定且支持 checksum）
• go env -w GOSUMDB=sum.golang.org（国内可用，不建议关掉）
注意：direct 是 fallback 机制，不是“跳过代理”，它只在代理返回 404 时才回源官方；若误写成 off 或空值，反而会导致校验失败。
验证命令：go env GOPROXY 应输出 https://goproxy.cn,direct
VS Code 中没有代码提示或调试器无法启动
这不是插件没装，而是 gopls、dlv 等底层工具没装全。VS Code 的 Go 插件首次打开 .go 文件时会弹窗提示“Install All”，但网络不通时静默失败，界面无报错。
必须手动补装：
• go install golang.org/x/tools/gopls@latest（语言服务器，补全/跳转核心）
• go install github.com/go-delve/delve/cmd/dlv@latest（调试器，F5 调试依赖）
• 若提示 cannot find module，先 cd $HOME/go/bin 看有没有生成对应二进制文件，没有就说明安装路径不对 —— 检查 GOBIN 是否被污染，推荐清空后让 Go 自动设为 $GOPATH/bin
另外，VS Code 设置里要关掉旧版 go.useLanguageServer（已废弃），只保留 "go.languageServerFlags": [] 默认值即可
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
go run main.go 成功但 go build 生成的可执行文件运行报错
尤其在 Windows 上，go build 出的 exe 双击闪退，CMD 里运行却显示 failed to initialize: failed to load DLL，大概率是 CGO 开启导致链接了本地动态库。
Go 默认关闭 CGO，但一旦项目 import 了含 C 代码的包（比如某些 SQLite、图像处理库），就会自动启用，编译结果不再静态链接。
解决办法：
• 编译前加环境变量：CGO_ENABLED=0 go build -o app main.go（Linux/macOS）或 set CGO_ENABLED=0 && go build -o app.exe main.go（Windows）
• 如果必须用 CGO，确保目标机器装了对应 runtime（如 mingw-w64 的 dll）
• 验证是否静态链接：Linux/macOS 用 ldd app，Windows 用 dumpbin /dependents app.exe，输出里不应出现 dll 名字
立即学习“go语言免费学习笔记（深入）”；
真正卡住新手的从来不是语法，而是go env 里那几行看似无关紧要的配置 —— 尤其 GOPROXY 和 CGO_ENABLED，一个影响能不能拉包，一个决定编译出来的程序能不能跑。别跳过验证步骤，每个 go env 输出都要亲手核对。 
