VSCode调试Go程序完全可行，但需正确安装go（≥1.16）、dlv及官方Go扩展，配置launch.json中program为目录路径而非文件路径，并确保GOPATH/bin在PATH中。
VSCode 调试 Go 程序完全可行，但必须装对扩展、配好 go 环境、且不能依赖默认 launch 配置——否则大概率卡在 “No debug adapter found” 或 “dlv not found”。
确认本地 go 和 dlv 已正确安装
VSCode 的 Go 扩展不自带调试器，它依赖系统级的 dlv（Delve）。只装 go 不行，只装扩展也不行。
-
go version必须 ≥ 1.16（推荐 1.20+），运行go env GOPATH记下路径 - 执行
go install github.com/go-delve/delve/cmd/dlv@latest安装dlv；成功后dlv version应能输出版本 - 确保
$GOPATH/bin（或go env GOPATH输出路径下的/bin）已加入系统PATH，否则 VSCode 启动调试时找不到dlv - Windows 用户注意：不要用 PowerShell 安装完就切回 CMD 调试——环境变量可能未同步
安装并配置 Go 扩展（不是“Go for Visual Studio Code”，是官方那个）
VSCode 商店搜 “Go”，认准发布者是 Go Team at Google。旧版叫 “Go for Visual Studio Code”，新版已统一为 “Go”。装错扩展会导致 go.mod 不识别、代码不补全、调试按钮灰掉。
- 安装后重启 VSCode，打开一个含
go.mod的文件夹，状态栏右下角应显示Go和当前 Go 版本 - 按
Ctrl+,打开设置，搜索go.toolsManagement.autoUpdate，设为true，避免手动装gopls、goimports等工具 - 如果编辑器提示 “Missing tool: gopls”，点击提示里的 “Install All” ——
gopls是语言服务器，没它就没有跳转、悬停、重命名等核心功能
调试前必须生成正确的 launch.json
直接点绿色 ▶️ 按钮调试会失败。必须通过命令面板（Ctrl+Shift+P）运行 Debug: Open launch.json，选择 Go 环境生成模板，再手动调整。
立即学习“go语言免费学习笔记（深入）”；
- 最简可用配置只改两项：
mode（通常为auto或exec）和program（指向main.go所在目录，不是文件路径） - 不要写
"program": "./main.go"—— 这是常见错误，program应为目录路径，Delve 会自动找main包 - 如需传命令行参数，加
"args": ["--flag", "value"]；如需工作目录隔离，加"cwd": "${workspaceFolder}/cmd/myapp" - 若项目用 Go Modules，确保
launch.json中没有硬编码GOPATH相关字段，Delve 会自动读取go.mod
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch Package",
"type": "go",
"request": "launch",
"mode": "test", // 或 "auto", "exec", "core"
"program": "${workspaceFolder}",
"env": {},
"args": []
}
]
}
断点不命中？检查 dlv 启动模式和构建标签
断点灰色、控制台输出 “Could not launch process: could not fork/exec” 或 “no source found for …” 多半是构建问题，而非配置错误。
- 确保当前文件属于
main包，且有func main()；非main包文件无法直接调试 - 如果用了构建标签（如
//go:build integration），需在launch.json的env里加"CGO_ENABLED": "1"，或在args加-tags=integration - 修改代码后务必保存（
Ctrl+S），Delve 不支持热重载；改了go.mod后需手动运行go mod tidy - Mac M1/M2 用户遇到
exec format error：说明dlv是 x86 编译的，删掉重装（go install会自动匹配架构）
真正卡住的地方往往不是配置本身，而是 dlv 是否在 PATH 里、go.mod 是否被识别、以及断点打在了根本不会执行的分支上——建议先用 dlv debug 命令行验证能否跑通，再回到 VSCode。
