go开发环境真正“可用”的底线是go命令可识别、gopls可启动、dlv可调试、goimports能格式化；需从终端启动vscode确保环境变量加载，手动安装gopls/dlv/goimports并配置go.formattool为goimports，国内用户必须设置goproxy。
go 命令能正常运行，且 gopls 可启动、dlv 可调试、goimports 能格式化——这才是 Go 开发环境真正“可用”的底线。其他花哨配置都建立在这个基础上。
确认 go 命令在终端和 VSCode 里都能识别
VSCode 启动方式直接影响它能不能读到你的 shell 环境变量（尤其是 PATH）。双击图标打开 VSCode，常导致 go 找不到；从终端执行 code . 才可靠。
- 先在终端运行
which go和go version，确保输出正常 - 再在 VSCode 集成终端里重复这两条命令——如果失败，说明 VSCode 没加载 shell 配置（如
~/.zshrc） - macOS 用户若用 zsh，检查
~/.zshrc是否导出了PATH，并确认 VSCode 是从该 shell 启动的 - Windows 用户注意：安装 Go 时勾选 “Add to PATH”；若已安装但没勾选，需手动把
C:\Go\bin和%GOPATH%\bin加入系统环境变量
让 gopls 语言服务器稳定跑起来
gopls 是 VSCode Go 插件的底层引擎，跳转、补全、诊断全靠它。但它不会自动装好，也不会报明显错误——只会在状态栏显示 “Go language server is not available” 或一直卡在 “Loading…”。
- 不要等插件自动下载；按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入并运行Go: Install/Update Tools - 勾选全部工具，重点确认
gopls、dlv、goimports已选中并完成安装 - 安装后检查
$GOBIN/gopls是否存在且可执行（GOBIN默认是$GOPATH/bin） -
go.goroot设置留空即可，填错路径会导致gopls启动失败且无明确提示 - 国内用户务必设
go.goproxy为https://goproxy.cn,direct，否则gopls初始化阶段会卡死在模块下载
保存即格式化必须用 goimports，不是 gofmt
默认的 gofmt 只格式化代码风格，不处理 import 分组与未使用包；而 goimports 会自动增删 import、按标准分组，是现代 Go 开发的事实标准。
- 在 VSCode 设置中搜索
go.formatTool，值设为goimports - 同时开启
editor.formatOnSave和[go].editor.formatOnSave - 确保
goimports已通过上一步的工具安装流程装好，否则保存时会静默失败 - 如果格式化后 import 没自动整理，大概率是
goimports没装成功，或go.formatTool写成了gofmt
调试前必须验证 dlv 和 launch.json 配置
断点不生效，90% 的原因是 dlv 没装、没权限，或 launch.json 里 program 路径写错了。
-
dlv必须通过Go: Install/Update Tools安装，不能只靠go install手动装（路径可能不一致） - macOS 上首次运行调试可能提示 “已损坏”，需在终端执行：
xattr -d com.apple.quarantine $(which dlv) - 项目根目录下必须有
main.go，且launch.json中program字段应为"${workspaceFolder}/main.go"，不是"./main.go"或绝对路径 - 推荐用
"mode": "test"调试测试函数，比"auto"更稳定；避免用"mode": "exec"，容易因二进制路径出错
gopls 和 dlv 的路径一致性、goimports 的启用时机、VSCode 启动方式对环境变量的继承——这些细节不显眼，但任何一个出问题，整个开发流就会卡住。别跳过验证步骤，尤其别信“装完插件就自动好了”。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
