go version报“不是内部或外部命令”是因为PATH未包含Go的bin目录；Windows需手动将C:\Go\bin加入系统环境变量Path，macOS/Linux需在~/.zshrc中添加export PATH=$PATH:/usr/local/go/bin并source，且必须新开终端验证。
go version 命令没反应？先确认 PATH 是否生效
安装完 go 后，go version 报“不是内部或外部命令”，基本是 PATH 没配对。Windows 默认安装路径为 C:\Go\bin，macOS/Linux 通常是 /usr/local/go/bin。别依赖“安装时自动配置”——实测 Windows MSI 安装器有时漏写系统变量，尤其是非管理员权限安装时。
- Windows：右键“此电脑”→属性→高级系统设置→环境变量→在“系统变量”的
Path里新增一行：C:\Go\bin（确认路径存在，且不含中文、空格） - macOS/Linux：检查
~/.zshrc或~/.bash_profile是否含export PATH=$PATH:/usr/local/go/bin；改完执行source ~/.zshrc - 验证：新开一个终端（不是旧窗口），再跑
go version。旧终端不会自动继承新环境变量
VS Code 里点“运行”没输出？检查工作区是否在模块根目录
VS Code 的集成终端默认在当前打开的文件夹下执行命令。如果 main.go 在子目录里（比如 src/main.go），直接按 Ctrl+F5 或终端输 go run main.go 会失败——Go 要求模块根目录下有 go.mod，且 main.go 必须在该目录或其子包中被正确识别。
- 正确做法：用 VS Code 打开的是整个项目文件夹（即含
go.mod的那一层），不是某个 .go 文件 - 没
go.mod？在项目根目录终端执行：go mod init example.com/hello（模块名可任意，但需符合域名格式） - 如果只有一两个文件又懒得建模块，临时方案：cd 进
main.go所在目录，再go run .（注意是英文句号，不是文件名）
断点不命中？Delve 没装或 launch.json 配置错
VS Code 点左侧行号设断点后，按 F5 没反应或提示 “No debugger installed”，说明 dlv 缺失或配置未生效。官方 Go 插件不会自动装 dlv，尤其在国内网络环境下常卡住。
- 手动安装：终端执行
go install github.com/go-delve/delve/cmd/dlv@latest（Go 1.21+ 推荐用@latest，避免版本冲突） - 检查是否装好：运行
dlv version，应输出类似Delve v1.25.0 -
launch.json必须放在.vscode/launch.json，内容至少含：{ "version": "0.2.0", "configurations": [ { "name": "Launch Package", "type": "go", "request": "launch", "mode": "auto", "program": "${workspaceFolder}" } ] }注意"type": "go"不能写成"go-debug"或留空
调试时变量显示 <not available>？编译选项影响调试信息
某些优化行为会让 Delve 无法读取局部变量值，典型表现是悬停看变量时只显示 <not available>，甚至单步跳过某行。这不是插件问题，而是 Go 编译器默认启用了部分优化。
立即学习“go语言免费学习笔记（深入）”；
- 解决方法：在
launch.json的配置里加"env": {"GODEBUG": "mmap=1"}（仅 macOS/Linux 有效），或更通用的做法——确保没手动加-ldflags="-s -w"这类剥离符号的参数 - 日常开发建议：不要在
go run时加-gcflags="-l"（禁用内联），它虽能提升调试体验，但会掩盖真实运行时行为 - 真正要发布时才用优化标志；调试阶段保持默认编译行为最稳妥
