go version报错说明PATH未包含Go二进制路径或安装失败：Windows用where go、macOS/Linux用which go确认命令可见性，检查GOROOT/bin是否加入PATH，并验证安装目录下存在go可执行文件。
go version 命令报错或无输出
说明 Go 二进制文件没进系统 PATH，或者根本没装成功。别急着重装，先确认两件事：go 命令是否能被 shell 找到，以及安装路径是否真的包含 go 可执行文件。
- Windows：打开新 CMD 或 PowerShell（旧终端不会自动加载新环境变量），运行
where go；如果没输出，说明 PATH 没生效，去「系统属性 → 高级 → 环境变量」里检查Path是否含C:\Go\bin（默认安装路径）或你自定义的GOROOT\bin - macOS/Linux：运行
which go；若为空，检查~/.zshrc或~/.bashrc是否有export PATH=$PATH:/usr/local/go/bin（macOS Homebrew 安装则通常是/opt/homebrew/bin）；改完记得source ~/.zshrc - 验证安装包完整性：去安装目录（如
C:\Go\bin或/usr/local/go/bin）手动双击/执行go，看是否弹窗报错 —— 若提示“缺少 VCRUNTIME140.dll”等，需装 Microsoft Visual C++ 运行库
VS Code 中 go extension 提示 “Installing tools failed”
这是新手最常卡住的环节，本质是 VS Code 尝试用 go install 下载一堆辅助工具（如 gopls、dlv），但国内直连 proxy 失败。不是插件坏了，也不是你网络全断了，只是默认代理不通。
- 优先执行命令行配置（比改 VS Code 设置更可靠）：
go env -w GOPROXY=https://goproxy.cn,direct，再加一句go env -w GO111MODULE=on - 删掉 VS Code 底部弹出的 “Install All” 提示，重启 VS Code，它会重新触发安装 —— 此时走的是你刚设好的代理
- 如果仍失败，手动装核心工具：
go install golang.org/x/tools/gopls@latest（注意不是 github 地址，官方已迁移到 golang.org）；装完再重启编辑器 - 别硬等全部工具装完：只要
gopls成功，基础语法高亮、跳转、补全就可用；dlv（调试器）可后续按需装
写完 hello.go 却 run 不出结果
常见错因不是代码写错，而是执行方式不对。Go 不像 Python 那样直接双击运行，它对当前工作目录和模块状态敏感。
- 确保你在
hello.go所在目录下执行：go run hello.go—— 如果在父目录或桌面运行，会报no such file or directory - 如果项目目录里有
go.mod文件（比如你之前go mod init过），但hello.go不在main包里，会报no main package；检查文件开头是不是package main - 不推荐用 Code Runner 插件一键运行：它默认用
go run .，但若当前目录有多个.go文件且没明确入口，会冲突；坚持用终端敲go run xxx.go更可控 - Windows 用户注意：CMD 默认编码是 GBK，而 Go 源码必须 UTF-8；若中文输出乱码，要么保存文件为 UTF-8 无 BOM，要么临时切终端：
chcp 65001
调试时 dlv 启动失败或断点无效
VS Code 的调试依赖 dlv（Delve）这个独立调试器，它不像 gopls 那样随插件自动装，且版本兼容性容易出问题。
立即学习“go语言免费学习笔记（深入）”；
- 先确认
dlv是否真装上了：dlv version；若报 command not found，运行go install github.com/go-delve/delve/cmd/dlv@latest - VS Code 调试配置（
.vscode/launch.json）里别乱改dlvLoadConfig或dlvArgs，新手用默认生成的配置即可；重点检查"mode": "auto"和"program": "${file}" - 断点不命中？常见原因是：文件没保存（VS Code 调试读的是磁盘文件，不是编辑器缓存）、断点打在非执行路径（比如
if false { ... }里）、或用了go run方式调试（应选「Launch Package」而非「Launch File」） - Mac M 系列或 Windows ARM 设备用户：Delve 对 ARM64 支持较新，务必用
@latest安装，避免用老旧教程里的固定版本号
