VS Code 调试 Go 失败主因是 dlv 未正确安装、launch.json 配置错误或 gopls 降级为 GOPATH 模式；需确认 dlv 路径与环境变量匹配、mode/program 按场景设对、项目启用 go.mod、调试时配置 env 并重启窗口。
VS Code 调试 Go 程序失败，90% 是 dlv 没装对、launch.json 配错，或 gopls 降级到 GOPATH 模式导致断点不命中——不是插件没装全，而是关键组件没对齐。
dlv 安装路径和权限必须匹配 VS Code 的预期
VS Code Go 扩展默认从 $GOPATH/bin 或 $GOBIN 查找 dlv，不会读取你手动加进系统 PATH 的任意位置。如果用 go install github.com/go-delve/delve/cmd/dlv@latest 安装后仍提示 “Delve not found”，大概率是环境变量没生效或安装目标路径不对。
- 运行
go env GOPATH和go env GOBIN，确认两者是否一致；若GOBIN为空，dlv就会落到$GOPATH/bin - 安装完立刻在终端执行
dlv version，确保命令可运行；如果报 “command not found”，说明$GOPATH/bin（或$GOBIN）没进 shell 的PATH - macOS / Linux 用户注意：修改
~/.zshrc或~/.bash_profile后要source，否则 VS Code 图形启动时读不到新 PATH - Windows 用户避免把
dlv.exe放进含空格或中文路径的目录，比如C:\Program Files\Go\bin—— VS Code 可能解析失败
launch.json 的 mode 和 program 必须按场景选对
mode 不是摆设，它决定 dlv 怎么加载代码；program 值错了，VS Code 根本不知道该调试谁。常见误配直接导致“点 F5 没反应”或“断点灰掉”。
- 调试命令行程序（有
func main()）：用"mode": "auto"或"mode": "exec"，"program": "${workspaceFolder}"（自动找main.go）或明确写成"${workspaceFolder}/cmd/myapp/main.go" - 调试测试函数：必须用
"mode": "test"，且"args"至少包含"-test.run=TestXXX"；只改program到_test.go文件无效 - 调试已编译二进制：用
"mode": "exec"，"program"指向可执行文件绝对路径（如"${workspaceFolder}/myapp"），此时源码必须和编译时完全一致，否则断点错位 - 不要用
"mode": "core"或"mode": "attach"除非你真在分析崩溃转储或远程进程——新手几乎用不到
gopls 降级为 GOPATH 模式会让所有智能功能失效
只要项目根目录没有 go.mod，gopls 就会回退到旧式 GOPATH 模式：跳转失效、补全不准、重命名出错，甚至调试时变量名显示为 main.x 而不是 x。这不是插件 bug，是设计使然。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 新建项目第一件事就是运行
go mod init example.com/myproj，哪怕暂时没外部依赖 - VS Code 打开文件夹后，看右下角状态栏：如果显示 “Go (GOPATH)” 而不是 “Go (Modules)”，说明
gopls已降级 - 检查
go.toolsEnvVars设置，别让工作区配置意外覆盖了模块感知能力；多模块仓库建议为每个子目录单独设go.toolsEnvVars - 禁用
"go.gopath"设置（留空），现代 Go 开发不需要它；设了反而干扰模块识别
调试 Web 服务时端口冲突和环境变量容易被忽略
启动调试后浏览器打不开、日志没输出、断点进不去——大概率是服务监听了已被占用的端口，或缺少关键环境变量（比如 GIN_MODE=debug），而这些在 launch.json 里不显式声明就不会生效。
- 在
launch.json的配置块里加"env"字段，例如："env": { "PORT": "8081", "GIN_MODE": "debug" } - 避免硬编码端口，改用随机空闲端口：在
env中设"PORT": "0"，然后从日志里看实际绑定的是哪个 - Web 服务调试时，别在
main()入口就设断点；先让服务起来，再在 handler 函数里下断，否则可能卡在 ListenAndServe 阻塞调用里 - 如果用
go run方式调试（即program指向.go文件），确保没同时在终端手动跑着另一个同端口服务
最常被跳过的一步：改完 go.mod 或 launch.json 后，不重启 VS Code 窗口。gopls 和 dlv 进程不会自动热重载配置，尤其是模块路径变更后，旧缓存会导致行为诡异。
