go test explorer 是独立插件，需手动安装并认准作者 ms-vscode.go-test-explorer；依赖 go.mod 和 gopls 正常工作，测试文件须为 *_test.go 且位于同一包内，否则 tests 视图为空。
Go Test Explorer 插件必须手动安装
VS Code 自带的 Go 扩展不包含图形化测试界面，Go Test Explorer 是独立插件，不会随 Go 扩展自动装上。搜索 “test” 或 “go test” 容易误装非官方插件（比如过时的 Go Test），务必认准作者是 ms-vscode.go-test-explorer（微软维护）。
- 打开扩展面板（
Ctrl+Shift+X），搜Go Test Explorer - 安装后需重启 VS Code，否则侧边栏不出现
TESTS视图 - 如果已装旧版（v0.4.x 及更早），升级到 v0.5.0+ 才支持 Go 1.21+ 的
go test -json输出格式
项目必须有 go.mod 且 test 文件在正确目录下
Go Test Explorer 依赖 go list -json -test ./... 扫描测试入口，没 go.mod 或测试文件命名/位置不对，整个侧边栏就是空的，连“刷新”按钮都不显示。
- 根目录运行
go mod init example.com/foo生成go.mod - 测试文件名必须以
_test.go结尾（如hello_test.go），且和被测代码在同一包内 - 不能放在
internal/或cmd/下——除非该目录本身有go.mod并被go list扫到 - 如果项目用
replace指向本地模块，确保路径存在且可读，否则扫描会静默失败
gopls 配置影响测试发现稳定性
VS Code 的 Go 插件靠 gopls 提供语义信息来定位测试函数，gopls 崩溃或未加载会导致测试列表卡住、点击无响应，但错误日志藏得深，用户只看到“Loading…”。
- 检查状态栏右下角：若显示
gopls (loading)或报红，先执行Go: Restart Language Server - 在
settings.json中确认启用了语言服务器："go.useLanguageServer": true - 禁用
"go.gopath"类旧配置项，避免与模块模式冲突 - 如果项目含 cgo 或嵌入汇编，
gopls可能跳过该包扫描——此时测试只能靠命令行go test手动跑
右键菜单和快捷键实际可用但默认未绑定
插件自带右键菜单（在测试函数名上点右键 → “Run Test” / “Debug Test”），但 Ctrl+Shift+T 这类快捷键不是开箱即用，必须手动配；而且快捷键只对光标所在函数生效，不是对整个文件。
- 打开键盘快捷键设置（
Ctrl+K Ctrl+S），搜test.explorer - 绑定
test.explorer.run和test.explorer.debug到常用组合键 - 注意：快捷键只在 .go 文件编辑器中有效，不在
TESTS侧边栏里起作用 - 调试时若断点不命中，检查
dlv版本是否 ≥ 1.22 —— 旧版不兼容 Go 1.22 的调试协议
go.mod 缺失或 gopls 卡死，就能让整个 TESTS 栏变成幽灵窗口——它不报错，只是沉默。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
