go version报错说明go二进制未加入PATH或安装失败；Windows需检查安装时是否勾选“Add Go to PATH”或手动添加C:\Go\bin，macOS/Linux需确认~/.zshrc中export PATH=$PATH:/usr/local/go/bin无拼写错误并执行source生效。
go version 命令报错或不识别
说明 go 二进制没进 PATH，或者根本没安装成功。这不是配置问题，是路径没生效或安装中断。
- Windows 用户检查安装时是否勾选了“Add Go to PATH”，没勾就手动把
C:\Program Files\Go\bin加进系统环境变量PATH - macOS/Linux 用户运行
source ~/.zshrc（或~/.bashrc）后仍无效，说明写入的export PATH=$PATH:/usr/local/go/bin行有拼写错误，比如漏了$或多加空格 - 别用
which go判断——它在某些 shell 下不可靠；改用command -v go，返回为空就是没找到 - 如果
go命令能执行但go version报permission denied，说明安装包解压后权限不对，Linux/macOS 上需运行sudo chmod +x /usr/local/go/bin/go
go env GOPATH 显示空值或默认路径不合理
现代 Go（1.16+）已默认启用模块模式，GOPATH 不再强制用于项目存放，但它仍影响 go install 输出的可执行文件位置（即 $GOPATH/bin），以及部分老工具链行为。
- 不要强行删掉
GOPATH——哪怕你只用go mod，dlv、gopls等工具仍依赖它来存缓存或二进制 - 推荐设为
$HOME/go（macOS/Linux）或%USERPROFILE%\go（Windows），避免路径含空格或中文，否则go install可能静默失败 - 设置后必须重启终端，或运行
go env -w GOPATH=/your/path（永久写入），别只改 shell 配置却忘了go env自己的缓存 -
go env -w GOBIN=/some/other/bin可单独指定可执行文件输出目录，但要确保该目录也在PATH中，否则装完命令找不到
VS Code 里无法启动调试或提示 “dlv not found”
这是最常被忽略的环节：VS Code 的 Go 扩展不会自动帮你装 dlv（Delve 调试器），它只检查是否存在，不存在就报错。
- 别点扩展里的 “Install all tools” 按钮——它在较新版本中已被移除，且容易因代理/权限失败
- 手动运行：
go install github.com/go-delve/delve/cmd/dlv@latest，注意不是go get（已弃用） - 如果卡在 “verifying ...”，大概率是模块代理问题，先运行
go env -w GOPROXY=https://proxy.golang.org,direct（国内可换为https://goproxy.cn） - 装完后检查：
dlv version应输出版本号；再确认 VS Code 设置里go.dlvLoadConfig和go.toolsGopath指向的是同一GOPATH - macOS 上若提示 “developer tools not installed”，运行
xcode-select --install，否则dlv编译底层组件会失败
go run main.go 成功，但 go build 后执行报 “no such file or directory”
这通常不是 Go 问题，而是你生成的二进制依赖了动态链接库，或当前目录下缺失运行时需要的资源文件（如模板、配置、静态文件）。
立即学习“go语言免费学习笔记（深入）”；
-
go build默认生成静态链接二进制（不含 CGO 时），但一旦用了cgo（比如调用 C 库、SQLite、某些图像处理包），就会依赖系统 libc，Linux 上常见于 Alpine 镜像——得用CGO_ENABLED=0 go build - 检查
ldd your_binary（Linux）或otool -L your_binary（macOS）看是否链接了外部库 - 更常见的是代码里用了相对路径读文件，
go run从源码目录执行，而go build后你在别处执行，路径就错了——统一用os.Executable()获取二进制路径再拼接资源 - Windows 上若报错含
api-ms-win-crt-*.dll，说明目标机器缺 VC++ 运行库，不是 Go 问题，得装 Microsoft Visual C++ Redistributable
