能直接断点调试需满足：dlv已安装且在path中、vs code的go扩展已启用、launch.json配置正确；其中dlv须用go install安装并验证version，launch.json需含正确program路径和request:"launch"，断点须打在可执行行且文件属于指定包路径。
能直接断点调试，前提是 dlv 已安装且在 PATH 中，VS Code 的 Go 扩展已启用，launch.json 配置正确 —— 缺一不可。
确认 Delve 调试器是否就位
VS Code 的 Go 调试能力完全依赖 dlv。它不是 VS Code 自带的，必须手动安装：
- 运行
go install github.com/go-delve/delve/cmd/dlv@latest（Go 1.21+ 推荐方式） - 安装后执行
dlv version，有输出即表示可用 - 若提示
command not found，检查GOBIN或$GOPATH/bin是否在系统PATH里 - Windows 用户注意：不要用
go get（已弃用），也避免装错分支（如derekparker/delve是旧地址）
生成并验证 launch.json 配置
VS Code 不会自动生成调试配置，必须存在 .vscode/launch.json。最简可用配置如下：
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch Package",
"type": "go",
"request": "launch",
"mode": "auto",
"program": "${workspaceFolder}"
}
]
}
-
program指向要调试的包路径：${workspaceFolder}适合单模块主程序；多模块项目需明确写成${workspaceFolder}/cmd/api等 -
mode: "auto"会自动识别是debug（编译后调试）还是exec（调试已编译二进制），日常开发够用；若需远程调试，才改用remote - 别漏掉
request: "launch"—— 写成"attach"会导致 F5 启动失败，且无明显报错提示 - 首次创建可点击左侧「运行和调试」视图 → 「创建 launch.json」→ 选 Go，但生成内容可能含冗余字段（如
port、host），建议删减至最小可用集
断点设置与调试启动的实操细节
配置完不等于能调，常见卡点都在这一步：
- 断点必须打在可执行行上：比如
message := "hello"行可以，但空行、注释行、函数声明行无法命中 - 确保当前打开的文件属于
program指定的包路径内，否则断点灰显（inactive） - 按
F5启动后，若控制台输出Failed to continue: Cannot find Delve debugger，说明dlv没被找到，不是代码问题 - 调试时变量面板默认只显示局部作用域变量；结构体字段若折叠不可见，右键变量 → 「调试：求值」可强制展开
- 多
main包项目（如cmd/cli和cmd/srv）需在launch.json中定义多个configuration，通过顶部下拉菜单切换
容易被忽略的环境前提
Delve 和 VS Code 都正常，不代表一定能调——Go 运行时环境常被低估：
-
GO111MODULE=on必须启用，否则模块路径解析错误，dlv可能找不到依赖或入口包 -
GOPATH不再强制要求，但若设置了，需确保不与模块路径冲突；GOROOT应指向真实 Go 安装目录（go env GOROOT可查） - 使用
go.work多模块工作区时，program路径必须相对于go.work根目录，而非 VS Code 打开的文件夹 - 某些 IDE 插件（如旧版 gopls）会干扰调试器启动，建议关闭非必要扩展测试
真正卡住的时候，往往不是 launch.json 写错了，而是 dlv 没装对、模块没启、或者 VS Code 根本没读到你认为它该读的那个 go.mod。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
