go test -cover 是 Go 内置的轻量级语句覆盖率分析工具，统计已执行源码行数占比；支持基础数值查看、HTML 可视化报告生成、跨包合并统计，并需注意其局限性与常见误区。
go test -cover 是 Go 内置的轻量级覆盖率分析工具，无需额外安装，适合日常开发中快速验证测试覆盖情况。它统计的是 被测试代码执行到的源码行数占比，不是逻辑分支或条件组合的覆盖率（如 MC/DC），但对判断测试完整性已非常实用。
基础用法：快速查看覆盖率数值
在项目根目录运行以下命令，即可获得当前包的覆盖率摘要：
go test -cover—— 输出类似coverage: 72.4% of statementsgo test -cover ./...—— 对所有子包递归运行，显示每个包的覆盖率（不含汇总）go test -covermode=count -cover—— 启用计数模式，可识别高频/低频执行路径（后续生成 HTML 报告必需）
生成可视化 HTML 报告
HTML 报告能直观定位未覆盖的代码行，是调试和补全测试的关键手段：
- 先生成覆盖率数据文件：
go test -covermode=count -coverprofile=coverage.out - 再转换为 HTML：
go tool cover -html=coverage.out -o coverage.html - 用浏览器打开
coverage.html，绿色为已覆盖，红色为未覆盖，灰色为不可测（如注释、空行、函数签名等）
跨包与模块级覆盖率统计
单个 go test 默认只覆盖当前包。要合并多个包的覆盖率数据：
立即学习“go语言免费学习笔记（深入）”；
- 分别生成各子包 profile：
go test -covermode=count -coverprofile=pkg1.out pkg1，依此类推 - 用
go tool cover -func查看各文件函数级覆盖详情，辅助聚焦重点 - 手动合并多个 .out 文件较繁琐，推荐使用
gocov或gotestsum等第三方工具（非标准库，需单独安装）
注意事项与常见误区
覆盖率数字本身不等于质量，需结合代码意图解读：
- 接口方法、空 struct 字段、panic 分支等可能天然难覆盖，不必强求 100%
-covermode=count比默认的set更精确，尤其利于发现“只跑过一次但实际应多路径验证”的逻辑- 测试中使用
t.Skip()或条件跳过时，对应代码仍计入分母，可能导致覆盖率虚低
