Go 覆盖率怎么按函数查看而不是只看总百分比

只看 go test -cover ./... 的总百分比，通常只能回答“整体覆盖了多少”，回答不了“下一组测试该补在哪个函数”。要按函数定位，先生成覆盖率 profile，再运行 go tool cover -func。它会列出文件、函数、语句数量和函数覆盖率，并在最后给出 total: 汇总行。

一、先生成覆盖率 profile，别只看终端总数

在模块根目录执行下面的命令。-cover 会让测试加入覆盖统计，-coverprofile 则把分析所需的 profile 写入文件；两者配合后，后续命令才能按函数展开。

# 运行所有包的测试，并保存覆盖率 profile
go test -coverprofile=cover.out ./...

# 只查看总览时仍可使用 cover，不要把它当成定位报告
go test -cover ./...

这里的 cover.out 是输入数据，不是最终结论。若只保留终端里类似 coverage: 68.4% of statements 的一行，测试范围还在，但函数之间的差异已经丢掉了。建议把 profile 放在临时构建目录或 CI 工作目录中，避免把一次运行的结果误当成长期基线。

二、用 go tool cover -func 按函数查看

有了 profile 后，直接运行：

# 按函数输出覆盖率明细
go tool cover -func=cover.out

典型输出会包含文件路径、函数名、语句数量和百分比，最后一行是整个 profile 的 total:。下面这个字段表是阅读重点：

三、把低覆盖函数变成补测试清单

函数报告适合做第一轮筛选。不要手工翻整份输出，可以先按百分比排序；下面的命令保留表头和汇总行，同时把中间函数行按最后一列排序。

# 按最后一列覆盖率排序，优先看到低覆盖函数
go tool cover -func=cover.out | awk 'NR == 1 || /total:/ {print; next} {print}' | sort -k3n

这个命令只改变显示顺序，不会修改 profile。实际补测时还要回到源码判断原因：是正常的错误分支、尚未覆盖的边界输入，还是测试根本没有构造出该函数的调用路径。一个只有两条可计数语句的函数显示 50%，和一个有数十条语句的 50%，补测优先级并不相同。

如果需要知道未覆盖的具体源码位置，再生成 HTML 报告：

# 生成源码级覆盖视图文件，不直接覆盖原 profile
go tool cover -html=cover.out -o coverage.html

-func 用于按函数筛选，-html 用于回到源码行定位；先用前者缩小范围，再用后者确认测试缺口，排查速度会更稳定。

四、函数级覆盖率能说明什么，不能说明什么

函数级报告能告诉你“哪些函数被覆盖得少”，但它不直接说明每个 if 分支都走过。Go 官方 cover 文档也说明它基于源码分析近似计算基本块，并不是对每个逻辑表达式内部都单独探测。因此，函数覆盖率适合做入口筛选，分支、错误返回和边界条件仍要靠具体测试用例复查。

还要注意 profile 的来源一致性：测试包范围、构建标签和运行参数不同，函数报告就可能不同。比较两次结果时，先固定 go test 的包范围，再比较同一批函数的百分比，避免把测试范围变化误判成代码质量变化。

相关问题

只想看某个包，命令怎么写？

把 ./... 换成具体包路径，例如 go test -coverprofile=cover.out ./internal/parser，这样 profile 只包含该包的测试范围。

函数覆盖率是 0% 就一定是缺测试吗？

不一定。它可能是未被当前包入口调用的错误处理或平台分支，先确认该函数是否属于本次测试目标，再决定补单测、补集成测试还是保留现状。

为什么总百分比提高了，某个函数仍然很低？

总百分比按全部统计语句汇总，新增测试可能覆盖了其他大函数；用 -func 逐函数看，才能区分整体提升和局部缺口。