go test -cover 默认只输出百分比而不生成报告，因为它不保存中间数据；要生成可分析的 coverage.out 文件，必须显式指定 -coverprofile=coverage.out 且推荐配合 -covermode=count 使用。
go test -cover 为什么只显示百分比，不生成报告
因为 go test -cover 默认只做一次性摘要计算，不保存任何中间数据——它压根没写文件，自然没法后续分析。
- 它只统计当前包下被
*_test.go文件实际执行到的语句，不递归子包，也不覆盖依赖包 - 如果你在模块根目录跑
go test -cover ./，会看到每个子包各行其是的覆盖率输出，但没有汇总值，也没有 profile 文件 - 想定位哪一行漏了、哪个
if分支没走，必须先生成可追溯的数据文件
怎么生成能定位问题的 coverage.out
关键就一条：加 -coverprofile=coverage.out，且推荐同步加 -covermode=count。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
go test -covermode=count -coverprofile=coverage.out .—— 注意末尾是.（当前包），不是./；用./会遍历子包，但只有最后一个包的覆盖率写进coverage.out，前面全被覆盖 -
-covermode=count记录每行执行次数，是后续热力图、冷区识别、分支验证的基础；set模式（默认）只记“有/无”，无法发现“只走了 if 没走 else”的问题 - Windows 下注意大小写：
Coverage.out≠coverage.out；CI 中建议先cd到 module root 再执行，避免路径错位
go tool cover -html 报错 open coverage.out: no such file 怎么办
这是最常卡住人的一步：文件根本没生成，或者生成了但你没在对的地方找。
- 确认命令里真有
-coverprofile=coverage.out；光写go test -cover是不会生成它的 - 检查当前目录下是否存在
coverage.out：ls -l coverage.out（macOS/Linux）或dir coverage.out（Windows） - 如果测试中途 panic 或 timeout，
coverage.out可能为空或损坏，此时重跑并加-v看是否真执行了测试函数 - 生成 HTML 命令必须和 profile 文件在同一目录：
go tool cover -html=coverage.out -o coverage.html
HTML 里大片灰色代码，是没覆盖还是编译器加的
灰色基本可忽略——它代表“不可测”，不是“未覆盖”。真正要盯的是红色（未覆盖）和绿色（已覆盖）。
- 灰色常见于：空行、注释、函数签名、接口转换桩、goroutine 启动辅助代码、内联后消失的函数体
- 如果某个函数整块灰，可能是被编译器内联了；加
//go:noinline可强制保留，方便调试覆盖情况 -
go tool cover -func=coverage.out更快定位低覆盖函数，比扫 HTML 高效得多；输出里看%和调用次数列，优先补0.0%的函数
go test -cover 就算看了覆盖率”，结果连哪行没跑过都不知道。真正的难点不在命令怎么敲，而在理解：覆盖率不是数字游戏，而是帮你追问“这个 error path 我真的试过了吗”“那个边界条件有没有触发 panic”的线索工具。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
