VSCode运行Go需确保环境变量、gopls和dlv正确加载：macOS/Linux须从终端启动以继承PATH，Windows需系统级配置GOROOT/GOPATH；必须双写GOPROXY并显式设置go.goplsPath/go.delvePath后重启窗口。
VSCode 能写 Go，但不是装完插件就自动好用——关键在环境变量、gopls 和 dlv 这三样东西是否被 VSCode 正确加载。很多“没提示”“断点不命中”“run 不了”，其实都卡在这几步上。
VSCode 找不到 go 命令？先看终端里 which go 有没有输出
VSCode 启动时不会完整继承 shell 的环境（尤其 macOS/Linux），所以即使你在终端能跑 go version，VSCode 可能压根不知道 go 在哪。
- 打开 VSCode 内置终端（
Ctrl+`），执行which go；如果为空，说明 PATH 没传进来 - 不要手动在
settings.json里填go.gopath—— Go 1.16+ 已弃用 GOPATH，填了反而干扰模块识别 - 正确做法：在 VSCode 设置中加
"go.toolsEnvVars": {"GOROOT": "/usr/local/go"}（路径以go env GOROOT输出为准） - 顺便执行
go env -w GOPROXY=https://goproxy.cn,direct，避免后续go mod download卡住
gopls 没启动或卡在 initializing？手动重装 + 清缓存
Go 插件的代码跳转、补全、格式化全靠 gopls，但它常因缓存错乱或代理问题静默失效，状态栏右下角只显示 “Go initializing…” 十几秒不动就是信号。
- 按
Ctrl+Shift+P，运行Go: Install/Update Tools，勾选gopls强制重装 - 确保项目目录里有
go.mod（哪怕空文件），或者至少有一个.go文件且 VSCode 是以该文件夹为根打开的（File > Open Folder） - 如果还卡住，删掉缓存目录：
macOS：$HOME/Library/Caches/gopls
Windows：%LOCALAPPDATA%\gopls - 临时禁用缓存可加配置：
"go.toolsEnvVars": {"GOPLS_CACHE_DIR": ""}（仅调试用，别长期开着）
调试时断点灰色、显示 “Unverified breakpoint”？检查 dlv 和 launch.json
VSCode 调试依赖 dlv，但默认安装方式容易架构不匹配（比如 macOS ARM64 上用 go install 装的 dlv 缺少 CGO 支持），导致无法 attach 进程。
立即学习“go语言免费学习笔记（深入）”；
- 别只信插件提示的 “Install All” —— 去 Delve Release 页面 下载对应系统+架构的二进制，扔进
/usr/local/bin或%PATH%目录 - 终端执行
dlv version，确认输出里有CGO_ENABLED=1；没有就说明不能调试 cgo 项目 -
.vscode/launch.json中：
单文件调试用"mode": "exec"并指定"program": "./main.go"
模块项目必须用"mode": "auto"或显式"mode": "exec"+"program": "." - cgo 项目务必加
"env": {"CGO_ENABLED": "1"}，否则符号加载失败，所有断点失效
真正容易被忽略的，是 VSCode 启动时拿到的环境和你在终端里用的根本不是同一套——多花半分钟验证 go env 和 which go 在 VSCode 终端里是否和外部一致，比反复重装插件有用得多。
