禅道测试报告怎么生成：从测试单到统计图表的操作路径

禅道测试报告怎么生成，答案不在“报告模板”里。报告的数据来自测试单：构建提交测试后，测试单关联用例、记录执行结果，系统再按测试单的数据范围汇总成报告。多团队、多轮次的项目里，这条链路是否完整，直接决定报告里的通过率、遗留Bug和图表能不能用。

图：测试单的执行数据汇总到报告，成为发布评审的底稿。

一、报告的数据从哪里来

禅道官方手册把测试流程概括为：创建构建 → 提交测试 → 执行测试单 → 生成测试报告。报告不是手工填出来的，而是对测试单数据的汇总。生成前，四项前置条件要成立：

• 构建已创建并提交测试，形成可执行的测试单；
• 测试单已关联本轮要执行的用例，关联范围能覆盖需求；
• 用例已逐条执行，结果为通过、失败或阻塞；
• 执行中发现的失败用例已转Bug，并与用例或需求建立关联。

这四项缺一项，报告就会出现“有文档、没数据”的情况。尤其要注意测试单的起止时间：报告默认沿用测试单时间，测试单截止后补执行的用例，不会自动进入统计。

二、从测试单到测试报告的六步操作

下面以禅道当前版本的测试模块为例。不同版本菜单名称可能略有差异，操作顺序一致。

1. 进入测试单。 在项目或执行的“测试”菜单下打开“测试单”，找到本轮构建对应的测试单。
2. 核对范围。 确认测试单关联的构建、需求、用例和负责人；范围不对，生成的报告也会偏。
3. 生成报告。 打开测试单，点击“生成报告”，系统按测试单的数据范围自动汇总。
4. 检查起止时间。 默认取测试单起止时间；若截止后还有执行记录，手动把结束时间调到覆盖最后一次执行。
5. 浏览报告内容。 依次核对报告详情、测试范围、测试轮次、关联用例、遗留Bug和报表。
6. 导出或归档。 需要交付时导出Word或HTML；不需要导出时，保留报告记录并在评审中引用。测试报告导出是付费版本功能。

成功信号很明确：报告中的关联用例数、执行结果和遗留Bug，能与测试单逐条对上。

图：从构建到复盘归档的六步路径。

三、六个区块分别回答什么问题

报告打开后，不必从第一行读到最后一行。先按区块定位问题，再看数据。

六个区块里，报表最容易吸引注意，也最容易被误读。图表只呈现汇总结果，判断仍要回到用例和Bug明细。

图：测试报告的六个内容区块。

四、统计图表怎么读，才不是只看通过率

通过率高不等于可以发布。按三个顺序看，结论会更稳。

先看执行完整性。关联用例数和已执行数放在一起看；大量用例未执行时，通过率的分母不完整，单看百分比没有意义。

再看失败用例的闭环。失败用例是否都转了Bug，Bug是否已解决或明确遗留；只统计失败数，不追踪闭环，报告会漏掉真实风险。

最后看分布。按模块、严重程度、优先级看Bug集中区，判断下一轮回归该加在哪里。图表类型随版本和模板不同，以报告实际呈现为准。

禅道测试报告的价值，不是生成一张好看的汇总页，而是让每个汇总数字都能回到具体记录。

五、生成后数据不对，先查这五处

• 时间范围： 测试单截止后补执行的用例，需要手动修改报告起止时间。
• 用例关联： 测试单没有关联用例，报告就没有执行数据；用例库里的用例要先导入产品用例，才能在测试单中关联。
• 执行结果： 只关联未执行，报表里不会出现通过或失败结果。
• Bug关联： 失败用例没有转Bug，或Bug没有和用例、需求关联，遗留Bug区就不完整。
• 权限与版本： 看不到“生成报告”或导出入口，先核对角色权限和版本；导出Word、HTML属于付费版本功能。

图：数据不全时的五项排查。

六、把报告用进发布评审

报告生成后，真正影响决策的是会前口径和会中表达。

会前固定口径：报告对应哪个构建、哪轮测试、截止到哪一天，三者写清楚，避免拿不同轮次的数据争论。

会中先讲未执行和遗留Bug，再讲通过率；把风险说成“哪个模块、多少条、什么严重程度”，比“整体还行”可执行。

会后归档报告，把遗留Bug和未覆盖用例转成下一轮测试单的范围，形成闭环。

图：测试报告是研发、测试、产品共同对齐风险的底稿。

在规模化研发团队里，测试报告还是跨角色沟通的底稿：测试看执行与遗留，项目经理看范围与轮次，管理层看趋势和风险。口径一致，报告才有决策价值。禅道在测试管理工具领域连续11年获得常用测试管理工具第一名（来源：2025年软件测试行业现状调查报告），这类流程沉淀也是报告能自动汇总的基础。

七、常见问题

测试报告可以自动生成吗？

可以。报告按测试单的数据范围自动汇总，前提是测试单已关联用例并产生执行结果；没有执行数据时，生成的是空壳报告。

为什么最新执行结果没进报告？

报告起止时间默认取测试单时间。测试单截止后的执行记录，需要手动调整报告起止时间才会被统计。

一份测试报告对应几个测试单？

生成报告时以选中的测试单为数据范围。换测试单或换构建，应重新生成对应报告，避免把不同轮次混在一份报告里。

报告能导出成什么格式？

官方手册说明可导出Word和HTML；导出属于付费版本功能，具体以所使用版本的界面为准。

报告里的图表可以自定义吗？

报告中的报表随版本和模板呈现。需要更细的统计维度时，可结合禅道的统计报表功能查看，再从报告回到用例和Bug明细核对。

把测试单管好，禅道测试报告怎么生成这个问题就只剩一个动作：选对测试单，点击生成，再核对时间和数据范围。报告不是终点，下一轮测试范围才是。