vscode golang 怎么调试-Golang-PHP中文网

dlv必须正确安装、launch.json需精准配置、断点须位于可执行路径上，三者缺一不可；否则F5调试将失效。

dlv

必须装对、launch.json 必须配准、断点必须落在可执行路径上——三者缺一，F5 就白按。

vscode 的 go 插件不会自动安装 dlv，只会在首次调试时弹窗提示“cannot find delve debugger”。这时候别点跳过，得手动装：

运行 go install github.com/go-delve/delve/cmd/dlv@latest（Go 1.21+ 强烈推荐用 @latest）
装完后在终端执行 dlv version，确认输出的 Go 版本和你本地 go version 一致
VSCode 里按 Ctrl+Shift+P → 输入 Go: Locate Configured Go Tools，检查 dlv 路径是否指向刚装的那个二进制（常见位置：$GOPATH/bin/dlv 或 $GOROOT/bin/dlv）
Windows 用户注意：如果用 WSL 开发，VSCode 必须是 WSL 版本（底部状态栏显示 WSL: Ubuntu），否则 dlv 和 go 环境不匹配，必报 fork/exec: no such file or directory

自动生成的配置常含过时字段，比如 "mode": "debug" 或 "mode": "auto" 在新版插件中已弃用。实际生效的只有三个合法值：exec、test、core。日常开发只用前两个：

调试主程序（含 main()）：用 "mode": "exec"，"program" 指向编译后的二进制路径，例如 "./main"；或更稳妥地写成 "${workspaceFolder}/main"
调试测试函数：用 "mode": "test"，并加 "args": ["-test.run=TestMyFunc"]
"program": "${workspaceFolder}" 看似方便，但仅当项目根目录下有且仅有一个 main 包才可靠；多包项目会失败
不要写 "remotePath" 字段——这是远程调试用的，本地调试留空或删掉，否则可能干扰断点匹配

VSCode 显示红点 ≠ 断点生效。常见假命中现象：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

断点打在 init() 函数里：dlv 默认不进入初始化阶段，除非你在 launch.json 里加 "stopOnEntry": true
断点打在未被调用的分支里（比如 if false { ... }）：编译器优化后该代码段根本不存在，断点变灰色，标为 Unverified breakpoint
项目用了 cgo 却没开 CGO_ENABLED：必须在 env 里显式写 "CGO_ENABLED": "1"，否则符号表加载不全，结构体字段全为空
源码和二进制不匹配：改了代码但没重新构建，或者 go build 时加了 -ldflags="-s -w" 去除了调试信息，断点必然失效

直接 F5 启动的进程默认没有命令行参数和环境变量，而很多 Go 服务依赖它们启动：

传参：在 launch.json 的 "args" 字段里写数组，例如 "args": ["-port", "8080", "-env", "dev"]
设环境变量：用 "env" 对象，例如 "env": { "GIN_MODE": "debug", "LOG_LEVEL": "debug" }
Web 服务调试时建议加 "showLog": true，这样调试控制台会输出 dlv 日志，看到 “listening on :8080” 才算真正跑起来了
如果服务监听 0.0.0.0:8080，别在浏览器里访问 localhost:8080 —— macOS/Windows 上 Docker 或某些网络栈会导致回环不通，优先试 127.0.0.1:8080