go开发环境问题核心在于path未配置、go.mod缺失、gopls未安装及dlv权限不足；需依次验证go version、go mod init、dlv version三命令。
go version 命令报错或找不到，说明 Go 二进制根本没进 PATH
VSCode 里点开终端就报 command not found: go，或者 go version 无输出，不是插件问题，是系统级安装没走通。Mac/Linux 用户常因 shell 配置文件没生效或路径写错导致；Windows 用户则多是 .msi 安装后没重启终端，或系统环境变量没刷新。
- 先在终端里直接运行
which go—— 如果空输出，说明go不在$PATH里 - 查安装位置：
/usr/local/go/bin（官方 pkg 默认）、/usr/local/bin/go（Homebrew 软链）、C:\Go\bin（Windows） - 对应编辑
~/.zshrc（Mac）、~/.bashrc或 Windows 系统环境变量，确保export PATH=$PATH:/usr/local/go/bin这类语句存在且没被注释 - 改完必须执行
source ~/.zshrc（或重启终端），否则配置不加载
VSCode 提示 “Go language server is not available”，大概率是 gopls 没装或路径不对
这个提示不是插件坏了，而是 VSCode 的 Go 插件启动 gopls 失败。它不会自动 fallback，关掉语言服务器等于退回到基础文本编辑器。
-
gopls不是靠插件内置下载就能稳用的——首次打开.go文件时自动拉取常因网络或代理失败，卡在“Installing tools…”不动 - 手动触发：Cmd+Shift+P → 输入
Go: Install/Update Tools→ 勾选全部，尤其确认gopls和dlv已选中 - 若卡住，先设代理：
export GOPROXY=https://goproxy.cn,direct（Mac/Linux），Windows 在系统变量里加GOPROXY值 - 装完检查：
ls $GOBIN/gopls应有可执行文件；VSCode 设置里go.goplsPath留空即可，别乱填路径
新建项目保存不格式化、跳转定义失效，缺了 go mod init 这一步
VSCode 的智能感知（补全、跳转、hover 提示）严重依赖模块上下文。没有 go.mod，gopls 就当整个目录是“无模块裸代码”，直接放弃分析。
- 不要在 VSCode 里右键新建文件就写代码——先打开集成终端，cd 到项目根目录，运行
go mod init example.com/myapp - 模块名不必真实可访问，但不能是
main或空字符串；推荐用 GitHub 路径风格，如github.com/you/project - 格式化要生效，还需开启 VSCode 设置：
editor.formatOnSave+go.formatTool设为goimports（不是gofmt） - 如果已写好代码再补
go mod init，记得删掉旧的import "."或相对路径导入，改用模块路径
断点不命中、调试报错 “could not launch process”，dlv 权限或 launch.json 配置错位
调试失败极少是代码问题，基本是 dlv 没装、没权限，或 VSCode 启动配置没对上当前入口。
-
dlv必须手动勾选安装（见第二步），装完验证：$GOBIN/dlv version有输出才算到位 - 确保项目根目录下有
main.go且含func main()；如果入口在子目录（如cmd/server/main.go），launch.json里"program"字段必须明确指向该路径 - 推荐用默认配置：
"mode": "auto"，VSCode 会自动识别是exec还是test；手动设"mode": "exec"时，"program"必须是编译后的二进制路径，不是.go文件 - macOS 上首次运行
dlv可能弹窗要求“允许辅助功能”，必须去「系统设置 → 隐私与安全性 → 辅助功能」里手动授权，否则进程被拦截
go version、go mod init、dlv version 这三行命令，比调一百遍设置更省时间。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
