go环境配置失败的根本原因是路径缺失而非环境变量不全，需确保go二进制所在目录（如/usr/local/go/bin或c:\program files\go\bin）加入path，并验证go env；vs code调试失败多因dlv未正确安装或launch.json配置不当。
go version 命令报错或不识别
说明 Go 二进制没进 PATH，或者安装根本没生效。这不是“环境变量没配全”的问题，而是最基础的路径缺失。
常见现象：command not found: go 或 zsh: command not found: go（macOS），'go' 不是内部或外部命令（Windows）。
- macOS 如果用
.pkg安装，默认会把/usr/local/go/bin写入/etc/paths，但某些终端（如 iTerm + zsh）可能不读该文件 —— 直接在~/.zshrc末尾加一行：export PATH="/usr/local/go/bin:$PATH"，然后source ~/.zshrc - Windows 用户如果用
.msi安装却仍报错，打开「系统属性 → 高级 → 环境变量」，确认PATH里有C:\Program Files\Go\bin（注意不是Go目录本身） - Linux 手动解压后，必须自己加
/usr/local/go/bin到PATH，且别漏掉source—— 否则新开终端还是找不到go
VS Code 中 Go 插件提示 “Missing tools”
这不是插件没装好，而是插件依赖的一组命令（比如 gopls、goimports、dlv）没装上。VS Code 的 Go 扩展不会自动帮你装它们，只弹窗提示你点“Install All”。
但实际中常失败，尤其在国内网络环境下。
- 先手动运行：
go install golang.org/x/tools/gopls@latest（这是语言服务器，必须） - 调试必需：
go install github.com/go-delve/delve/cmd/dlv@latest—— 注意不是go get，go get在 Go 1.21+ 已弃用 - 格式化常用：
go install mvdan.cc/gofumpt@latest（比原生gofmt更严格） - 所有工具默认装到
$GOPATH/bin，确保该路径已在PATH中，否则 VS Code 找不到
go mod init 报错 “cannot determine module path”
说明当前目录不在 GOPATH 下，又没显式指定模块名 —— Go 1.13+ 默认开启模块模式，但不会自动猜路径。
典型错误信息：go: cannot determine module path for source code directory
- 最简单解法：执行
go mod init example.com/myproject，随便起个域名前缀（不用真实存在），只要符合domain.tld/name格式就行 - 别用本地路径如
go mod init /Users/xxx/myapp—— 这会直接报错 - 如果项目已有
go.mod但路径不对，删掉重来；不要试图用go mod edit -module修，容易引入版本混乱 - 模块名一旦写进
go.mod，后续所有import都要按这个前缀写，改名成本高
调试时 F5 启动失败，提示 “Failed to launch”
表面是 VS Code 配置问题，根因通常是 dlv 没装对，或项目结构不符合调试器预期。
常见现象：断点灰色不可用、控制台输出 could not launch process: fork/exec ... no such file or directory
- 确认
dlv可执行：终端里运行dlv version，有输出才代表装成功 -
launch.json中"program"字段不能指向单个.go文件，必须是包目录路径（比如"${workspaceFolder}"），且该目录下要有main.go和package main - 如果项目用了
replace或exclude，Delve 可能无法加载符号 —— 临时注释掉go.mod里的这些行再试 - macOS 上若提示权限错误，需在「系统设置 → 隐私与安全性 → 完全磁盘访问」里给 VS Code 手动授权
GOPATH、PATH、go.mod 里的模块名，三者稍有错位，就会在不同环节冒不同错误，而且提示语毫无关联。动手前先跑一遍 go env，比看十篇教程都管用。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
