vscode 依赖 vscode-go 扩展调用 go test 生成 coverage.out 并渲染覆盖率；必须在含 *_test.go 的模块根目录打开工作区，用 -coverprofile、-coverpkg 和 -covermode=count 参数正确执行 go test，再手动触发“go: toggle test coverage”才能显示标记。
VSCode 本身不运行 Go 测试，也不生成覆盖率数据；它只靠 vscode-go 扩展调用 go test 命令，并解析其输出——想看到测试列表和覆盖率标记，必须让 go test 正确执行并生成 coverage.out，再由扩展读取渲染。
go test 要能跑起来，不是“有_test.go 就行”
常见现象是点击“Run Test”没反应、侧边栏空、终端报 no test files 或 0.0%。根本原因不是配置错，而是命令根本没执行成功：
- 必须在含
*_test.go文件的目录下打开 VSCode 工作区（或设为当前文件夹），go test默认只扫当前包 - 测试文件名必须严格为
xxx_test.go，不能是test_xxx.go或xxx.test.go - 如果项目用 Go modules，工作区根目录得是
go.mod所在路径，否则go test找不到依赖、静默跳过 - 想测子包（如
./pkg/http），得手动在终端运行go test ./pkg/http，VSCode 默认不递归
覆盖率文件 coverage.out 必须带 -coverpkg 显式指定范围
go test -coverprofile=coverage.out 单独执行后，coverage.out 经常为空或只有几行——这不是插件问题，是 go test 没插桩业务代码：
- 默认只覆盖当前测试文件所在包，不会自动包含它
import的其他包（比如http.Serve()在pkg/http里，但测试在main包，不加参数就测不到） - 必须加
-coverpkg：测整个模块用go test -coverprofile=coverage.out -coverpkg=./ ./；只测部分子包用-coverpkg=./pkg/http,./pkg/model ./ -
-covermode=count比默认的set更准（支持分支统计），CI 校验阈值必须用这个模式
vscode-go 扩展要识别 coverage.out 并高亮，不是放那儿就自动显示
vscode-go 自带覆盖率支持，但需确认三件事：
- 确保已安装最新版
vscode-go（非旧版Go扩展），地址是 https://www.php.cn/link/67affeff02107f710f7dd48c8fcc5365 - 在 VSCode 设置中启用：
"go.coverageOptions": { "mode": "count" }，且"go.toolsManagement.autoUpdate": true（保证gopls支持 coverage） - 生成
coverage.out后，必须手动触发命令面板（Ctrl+Shift+P），输入并运行Go: Toggle Test Coverage，才能在编辑器 gutter 区显示红/绿标记 - 灰色行 ≠ 未覆盖，很可能是不可插桩内容（空行、注释、
func main() { }里未执行语句），用go tool cover -func=coverage.out看函数级数据更可靠
最容易被忽略的是：VSCode 不会自动重跑测试来刷新覆盖率。每次改完代码，你得自己在终端跑一遍带 -coverprofile 和 -coverpkg 的 go test，再手动触发 Go: Toggle Test Coverage。没有“保存即更新”这回事。
