VSCode Go开发需手动配置扩展与工具链，核心是正确安装Go SDK、gopls和delve，并确保GOROOT、GOPATH及PATH路径准确；调试须配置launch.json并验证dlv权限。
VSCode 本身不内置 Go 支持，必须手动配置扩展与工具链；没装对 gopls 或 delve，调试断点会直接失效，测试覆盖率也跑不起来。
安装 Go SDK 和验证 GOROOT / PATH
Go 开发环境崩溃的 70% 源于路径没配对。Windows 用户尤其注意：不能只靠安装包默认路径，得手动检查 go env GOROOT 输出是否和实际安装目录一致，且 go 命令必须能全局调用。
- 从 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载最新稳定版（非 beta），运行安装程序（macOS/Linux 解压后把
bin加入$PATH） - 终端执行
go version，确认输出类似go version go1.22.3 darwin/arm64 - 执行
go env GOPATH，记下该路径（如/Users/xxx/go），后续go install工具会默认装到bin子目录 - 确保
$GOPATH/bin已加入系统PATH（否则 VSCode 启动后找不到dlv、gopls）
安装 Go 扩展并强制启用 gopls
VSCode 的 Go 扩展（由 Go team 官方维护）已弃用旧的 gocode/guru，必须用 gopls 作为语言服务器——它负责自动补全、跳转、格式化等所有智能功能。禁用或未正确安装 gopls，编辑器就退化成纯文本编辑器。
- 在 VSCode 扩展市场搜 “Go”，安装 “Go by Go Team at Google”（ID：
golang.go） - 打开命令面板（
Cmd+Shift+P/Ctrl+Shift+P），运行Go: Install/Update Tools - 勾选全部工具，重点确认
gopls和dlv被选中 → 点击Install - 安装完成后，重启 VSCode；打开一个
.go文件，底部状态栏应显示gopls (running) - 若显示
gopls (starting...)卡住，检查go env GOPATH对应的bin/gopls是否存在且可执行
配置 launch.json 实现真断点调试
VSCode 默认不生成调试配置，必须手动创建 .vscode/launch.json。用错 mode 或漏掉 dlv 路径，调试器根本起不来，或者断点灰色不可用。
立即学习“go语言免费学习笔记（深入）”；
- 在项目根目录建
.vscode/launch.json，内容如下（适用于单文件调试）：
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch Package",
"type": "go",
"request": "launch",
"mode": "test", // 调试 test 函数用
"program": "${workspaceFolder}",
"env": {},
"args": []
},
{
"name": "Launch File",
"type": "go",
"request": "launch",
"mode": "auto", // 自动识别 main 或 test
"program": "${file}",
"env": {},
"args": []
}
]
}
-
mode必须为auto、exec（运行已编译二进制）、test（运行go test）之一；debug是过时写法，会报错 - 确保
dlv可执行文件在$PATH中（验证：终端运行dlv version） - 调试前，务必先保存文件（VSCode 不自动保存），否则断点打在未保存版本上
运行测试与查看覆盖率的实操要点
VSCode 内置测试按钮（左下角虫子图标旁的播放键）本质是调用 go test，但默认不带 -cover，也不展示 HTML 覆盖率报告——得靠配置 + 命令行补位。
- 右键点击测试函数（如
func TestXXX(t *testing.T)），选择Go: Run Test，即可触发调试模式运行 - 要生成覆盖率报告：终端进入项目根目录，运行
go test -coverprofile=coverage.out ./...，再运行go tool cover -html=coverage.out -o coverage.html - VSCode 的测试视图（Test Explorer）需开启：在
settings.json中加"go.testExplorer.enable": true，重启后侧边栏出现测试图标 - 注意：
go test默认不递归扫描子模块，./...才能覆盖所有子目录；单测文件名必须以_test.go结尾
最常被忽略的是 dlv 权限问题：macOS 上首次调试可能弹窗提示“是否允许调试器控制此电脑”，必须点“允许”，否则进程立即退出；Linux 用户需确认 ptrace 未被禁用（cat /proc/sys/kernel/yama/ptrace_scope 应为 0）。
