vscode调试go失败90%因gopls未运行、dlv安装路径错误或launch.json配置失配：须从终端执行code .启动，显式设gobin为$home/go/bin，手动安装gopls/dlv并验证路径，确保项目含go.mod且launch.json中program设为"${workspacefolder}"。
VSCode 调试 Go 失败，90% 不是插件没装，而是 gopls 没跑起来、dlv 装错位置，或 launch.json 配错了路径——尤其 Windows 和 macOS 用户常因启动方式不同导致环境变量丢失。
从终端执行 code . 启动项目
双击图标打开 VSCode 会丢失 shell 的 $PATH（比如 ~/.zshrc 或 ~/.bash_profile 里设的 GOBIN），导致它找不到 gopls 或 dlv。
- 必须在项目根目录下运行：
code . - 确认
go version和which dlv在同一终端能正常输出 -
GOBIN建议显式设为$HOME/go/bin，避免和旧版GOPATH/bin混淆 - Windows 用户若用 PowerShell，需提前运行：
$env:GOPROXY="https://goproxy.cn,direct"
手动安装 gopls 和 dlv
VSCode Go 插件内置的 “Install All” 在国内大概率卡死或 404，不能依赖自动安装。
- 先设置代理：
export GOPROXY=https://goproxy.cn,direct（macOS/Linux） - 运行安装命令：
go install golang.org/x/tools/gopls@latest和go install github.com/go-delve/delve/cmd/dlv@latest - 验证是否装对位置：
ls $GOBIN/gopls和which dlv应输出$GOBIN/dlv，不是/usr/local/bin/dlv（Homebrew 安装的 VSCode 默认不认） - 装完关掉所有 VSCode 窗口，再从终端重开
launch.json 必须匹配项目结构
断点不生效、调试按钮灰掉、“program not found” 错误，几乎都源于配置与实际代码布局不一致。
-
launch.json必须放在项目根目录下的.vscode/文件夹中 -
"program": "${workspaceFolder}"是最安全写法，前提是项目根目录有main.go且含func main() - 不要写成
"program": "./main.go"或子目录路径，除非你明确用"mode": "test" - 项目必须已初始化模块：终端运行
go mod init example.com/foo，否则 VSCode 拒绝加载调试器 - Windows 用户首次调试前建议先在终端运行一次
dlv version，避免权限弹窗阻塞
格式化和 import 管理失效的两个开关
这不是语言服务器问题，而是 VSCode 设置里两个关键项被忽略。
- 开启保存时格式化：
editor.formatOnSave设为true - 指定格式化工具：
go.formatTool必须设为goimports（不是gofmt），否则 import 不会自动增删 -
go.goroot建议留空——填错会导致gopls静默失败，且无错误提示
最容易被忽略的是：gopls 是否真在 $GOBIN 下、VSCode 是否从终端启动、go.mod 是否存在。这三个点任一出错，调试界面就变成“看起来装了，实际动不了”的状态。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
