Go调试需匹配dlv启动模式与工程构建方式：确认dlv≥1.21.0且PATH包含$GOPATH/bin；launch.json中mode须为test/exec等且program指向模块根目录；禁用-strip标志并确保module初始化和GOPROXY配置正确。
Go 语言的调试体验在 VS Code + dlv 组合下已经非常成熟，但直接装插件不配置会卡在“找不到进程”或“断点不命中”——核心问题不是工具没装，而是 dlv 启动模式和 Go 工程构建方式不匹配。
确认 dlv 是否可用且版本兼容
VS Code 的 Go 插件（Go Nightly）默认依赖 dlv，但 Go 1.21+ 要求 dlv ≥ 1.21.0，旧版会静默失败。运行以下命令验证：
dlv version
若提示 command not found，用 go install 安装（不要用 brew 或 apt）：
go install github.com/go-delve/delve/cmd/dlv@latest- 确保
$GOPATH/bin在$PATH中（常见遗漏点） - Windows 用户注意：安装后需重启终端，否则 VS Code 无法继承 PATH
launch.json 中必须指定 “mode” 和 “program”
VS Code 的 .vscode/launch.json 里，dlv 不接受模糊路径。以下配置是最低可行集：
立即学习“go语言免费学习笔记（深入）”；
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch Package",
"type": "go",
"request": "launch",
"mode": "test", // ← 若调试 test 文件，必须设为 "test"
"program": "${workspaceFolder}", // ← 必须是目录路径，不是 .go 文件
"args": ["-test.run", "TestFoo"]
}
]
}
关键点：
-
mode只能是auto、exec、test、core、exec—— 没有debug或run -
program指向模块根目录（含go.mod），不是单个main.go - 调试单文件无
go.mod？改用mode: "exec"+ 先go build -o main main.go
断点不命中？检查 GOPROXY 和 module 初始化状态
常见现象：加了断点，F5 启动后直接退出，控制台无错误。大概率是模块未正确识别：
- 执行
go mod init example.com/foo（哪怕只是临时初始化） - 确认
go env GOPROXY不是direct或空值；国内建议设为https://goproxy.cn - VS Code 底部状态栏右下角应显示 “Go (GOPATH)” 或 “Go (Module)”，若显示 “No SDK” 则
GOROOT配置错误 - 调试时禁用
go build -ldflags="-s -w"—— 这两个 flag 会剥离调试符号，导致断点失效
最易被忽略的是：用 go run main.go 能跑，不代表 dlv 能调试。它需要完整的模块上下文或显式编译产物。调试前先 go list -m 看是否在 module 模式下，比反复重启 VS Code 有效得多。