最常见原因是-coverprofile参数漏掉等号，必须写为-coverprofile=coverage.out；其他原因包括无_test.go文件或test函数、./...扫描到vendor/等被排除目录、路径含空格或中文。
go test -coverprofile 为什么没生成 coverage.out 文件
最常见原因是参数写错：把 -coverprofile coverage.out（空格）当成合法写法，实际必须带等号——-coverprofile=coverage.out。漏掉等号会静默失败，文件不创建，也不报错。
其他典型原因：
- 当前目录下没有
*_test.go文件，或文件里没定义以Test开头的函数，go test直接跳过，不生成 profile - 用了
./...但项目结构含vendor/或testdata/，部分子包被排除，导致看似跑完了却没写入数据 - 路径中存在空格或中文，某些 shell 环境下解析异常（建议用纯英文路径）
覆盖率数字虚高，怎么拿到真实值
go test -cover 默认统计范围太窄：自动过滤 _test.go、vendor/、条件编译块（如 //go:build ignore）、注释行——分母变小，百分比自然偏高。
要贴近真实业务代码覆盖，必须显式控制范围：
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 加
-coverpkg=./（单包）或-coverpkg=github.com/your/repo,github.com/your/repo/internal（多包），确保依赖的内部包也被计入 - 用
go list ./ | grep -v vendor | grep -v _test.go过滤出实际参与构建的包路径，再拼进-coverpkg - 别只看总百分比；用
go tool cover -func=coverage.out查每个函数的覆盖，重点盯 handler、error 分支、边界逻辑
go tool cover -html 打开是空白页
不是文件损坏，是浏览器禁用了 file:// 协议下的 JS 执行——HTML 报告依赖 JS 渲染高亮，双击打开必然白屏。
正确做法只有两种：
- 直接运行
go tool cover -html=coverage.out，它会起本地 HTTP 服务（默认端口59090），访问http://localhost:59090即可 - 手动起服务：
python3 -m http.server 8000，然后打开http://localhost:8000/coverage.html - 绝对不要改文件后缀、挪动位置、或用编辑器打开
coverage.out（它是二进制，非文本）
颜色看不懂，误把灰色当未覆盖
HTML 报告里颜色有明确语义，混淆会导致补测方向错误：
- 绿色：该行被执行 ≥1 次（但不等于分支全覆盖，比如
if x > 0 { A } else { B }只测了 A，B 仍是红色） - 红色：该行完全未执行——是真正要补测的部分，尤其是
else、default、if err != nil分支 - 灰色：不可执行代码（空行、注释、函数签名、
type定义、甚至没写 body 的default分支）——这些不参与覆盖率计算，不用写测试去“刷绿”
最容易被忽略的是：灰色不是缺陷，红色才是。盯着灰色优化，纯属浪费时间。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
