测试通过率的口径要先把三件事定死：分子是哪些执行结果算“通过”，分母是哪些用例执行记录进入统计，时间窗与统计对象是哪个版本或哪轮测试。常见写法是“通过执行数 ÷ 有效执行数 × 100%”，其中有效执行数剔除未执行、阻塞和作废记录，重跑按最后一次结果计。本文给出一套可复算的口径定义、计算步骤与算例，帮助同一版本在不同报告中得到一致数值。
要点总览（TL;DR）
- 测试通过率的口径先定三件事：分子计入哪些执行结果、分母纳入哪些执行记录、统计对象是哪个版本或哪轮测试。
- 常用公式为“通过执行数 ÷ 有效执行数 × 100%”，有效执行数剔除未执行、阻塞和作废记录，同一用例重跑按最后一次有效结果计。
- 口径要写成字段级说明，固定用例ID、执行结果、执行时间、版本与轮次标识、执行人，并用一组已知数据回算，核对报告数值与明细一致。
- 通过率反映执行结果分布，解读时需结合用例覆盖范围、失败严重程度和样本量；跨版本、跨团队比较前先确认用例集与口径一致。
测试通过率要回答哪个版本结论
测试通过率首先服务于一个具体判断：当前版本或当前测试轮次的执行结果是否达到本轮预期。它回答的是“这一轮测过的用例里，通过的比例是多少”，使用者据此在测试报告中给出本轮结论、在缺陷复盘中定位失败集中的模块、在版本之间做同口径对比。
这个指标有明确的边界。它不回答组织级质量趋势，那需要跨多个版本、多个团队按统一口径长期汇总；它也不直接构成发布门禁，门禁还要结合缺陷严重度、遗留缺陷数量、关键用例覆盖情况等条件共同判断。把通过率单独当作发布依据，容易忽略未覆盖的功能区域和高风险缺陷。
因此，口径确定的第一步是写下一句话定义，例如：“本指标统计 V2.3 版本第一轮系统测试中，指定用例集的有效执行记录通过比例，用于本轮测试报告结论，不用于跨团队排名。”这句话同时锁定了版本、轮次、用例集和用途，后续所有取数与计算都围绕它展开。
分子分母与统计范围怎么界定
分子和分母的定义决定了数值本身。分子只计入明确判定为“通过”的执行结果；分母计入“有效执行数”，即真正产生了可判定结果的执行记录。两者都按执行记录计数，还是按用例计数，需要事先声明，因为同一批数据在两种粒度下可能得出不同数值。
常见处理规则如下：执行结果为“通过”的计入分子；结果为“失败”的计入分母但不计入分子；“部分通过”若组织内将其视为未通过，则计入分母不计入分子，若视为通过则需在口径说明中单独标注并保持跨轮次一致。未执行、阻塞、作废的记录不计入分母，因为它们没有产生可判定的执行结果。同一用例在同一轮次内多次执行时，按最后一次有效结果计，避免重跑把分母放大。
| 字段 | 取值规则 | 示例值 |
|---|---|---|
| 统计对象 | 版本号 + 测试轮次 + 用例集 | V2.3 / 第一轮系统测试 / 核心交易用例集 |
| 时间窗 | 本轮测试起止时间，按执行时间归属 | 2026-03-02 至 2026-03-06 |
| 计数粒度 | 按用例计数，重跑取最后一次有效结果 | 1 条用例计 1 次 |
| 分子 | 执行结果为“通过”的用例数 | 86 |
| 分母 | 有效执行数 = 通过 + 失败 + 部分通过（按未通过计） | 100 |
| 剔除项 | 未执行、阻塞、作废、重复执行的历史记录 | 剔除 12 条未执行、3 条阻塞 |
| 单位 | 百分比，保留一位小数 | 86.0% |
统计范围还要明确用例集的边界：是全量用例、本轮计划内用例，还是按优先级筛选的核心用例。范围不同，通过率不可直接比较。时间窗按执行时间归属，跨轮次补测的记录应归入其实际执行所在轮次，并在口径说明中写明。
数据从哪里取、如何保证可复算
可复算的前提是每条进入统计的记录都能被单独定位和复核。数据来源是测试管理工具中的执行记录与用例状态字段，取数时应固定以下字段：用例ID、用例所属用例集、执行结果、执行时间、版本标识、轮次标识、执行人。缺少任一字段，后续复核就可能出现无法归因的记录。
缺失值与异常记录需要预先定规则：执行结果为空或状态不明的记录不计入分母，并单独列出清单；执行时间缺失的记录按导入时间或轮次默认时间归属，并在报告中注明；同一用例同一轮次存在多条结果时，按执行时间取最后一条，其余作为历史记录留存但不参与计算。作废记录需保留作废原因，便于回溯。
证据留存建议同时保存两类材料：一是按上述字段导出的执行明细，二是计算完成时的汇总快照，包含分子、分母、剔除项数量和计算时间。测试管理工具通常支持用例属性自定义与筛选，把版本、轮次设为可筛选属性，可以让取数条件固化为可重复使用的筛选器。ONES 测试管理支持用例属性自定义、用例库属性筛选，并支持用例导入导出，便于把执行明细导出后与报告数值逐条核对；其测试情况概览可查看测试计划的进度和通过率，测试报告支持自定义组装模板。具体通过率字段的默认计算规则以实际配置为准，口径说明中应写明本团队采用的分子分母定义。
通过率的计算步骤与公式
公式为：通过率 = 通过执行数 ÷ 有效执行数 × 100%。有效执行数 = 通过执行数 + 失败执行数 + 按未通过处理的部分通过执行数。计算按以下步骤执行：
- 取数：按版本、轮次、用例集、时间窗导出执行记录，字段齐全。
- 清洗：剔除未执行、阻塞、作废记录，标记缺失字段记录并单独列出。
- 去重：同一用例同一轮次保留最后一次有效执行结果，历史记录留存不参与计算。
- 汇总：按轮次统计通过数、失败数、部分通过数，得到分子与分母。
- 计算：分子除以分母乘以 100%，保留一位小数。
边界情况需要明确展示方式。分母为零时，通过率不显示为 0%，而应标注“无有效执行”，避免被误读为全部失败；有效执行数过少时（例如少于 10 条），建议同时给出绝对数量和样本量提示，说明该数值的参考价值有限。重跑与补测记录归并到同一用例，只保留最后一次有效结果，若补测发生在下一轮次，则计入下一轮次并在报告中说明跨轮补测情况。
用一组数据回算验证口径
下面用一组演示数据验证口径。假设 V2.3 第一轮系统测试计划执行 120 条用例，实际记录分布如下：通过 86 条，失败 9 条，部分通过 5 条（按未通过计），未执行 12 条，阻塞 3 条，另有 5 条为同一用例的重跑记录（最后一次结果为通过，已归并）。
| 执行结果 | 记录数 | 是否计入分母 | 是否计入分子 |
|---|---|---|---|
| 通过 | 86 | 是 | 是 |
| 失败 | 9 | 是 | 否 |
| 部分通过（按未通过计） | 5 | 是 | 否 |
| 未执行 | 12 | 否 | 否 |
| 阻塞 | 3 | 否 | 否 |
| 重跑历史记录（已归并） | 5 | 否 | 否 |
按本文口径：分子 = 86，分母 = 86 + 9 + 5 = 100，通过率 = 86 ÷ 100 × 100% = 86.0%。
若换一种口径，把未执行和阻塞也计入分母，则分母变为 115，通过率为 86 ÷ 115 ≈ 74.8%；若把部分通过计为通过，则分子为 91，通过率为 91.0%。三种口径差异明显，说明口径必须在报告出具前固定，并在报告中注明。回算时还应核对：明细中通过记录数是否与报告分子一致，剔除项数量是否与清洗清单一致，重跑归并后的用例数是否与计划用例数匹配。三项核对通过，报告数值才可视为可复算。
结果怎么解读、口径有哪些限制
通过率反映的是执行结果的分布，不能直接等同于质量水平。一个版本通过率高，可能因为用例设计偏宽松、覆盖的功能区域有限，也可能因为高风险场景尚未纳入本轮用例集。解读时应结合用例覆盖范围、失败用例的严重程度和缺陷分布一起看。
跨版本、跨团队比较需要满足前提：用例集范围一致、用例设计标准一致、统计口径一致、时间窗长度可比。口径发生变更时，应记录变更时间、变更原因和影响范围，并在历史数据上标注是否可比；必要时用新旧两套口径对同一批数据各算一次，给出差异说明。
使用限制可以归纳为几条：通过率不覆盖未执行和阻塞部分所代表的风险；它不衡量缺陷的严重程度和修复质量；它依赖用例设计的有效性，用例本身偏差会直接传导到结果；单轮次数值波动较大时，不宜据此做趋势判断。把通过率作为测试报告的一项结论依据，同时列出样本量、剔除项和口径版本，才能让读者正确理解这个数字的含义。
常见问题
部分通过的用例应该计入分子还是分母？
这取决于团队对“通过”的判定标准，关键是写进口径说明并保持跨轮次一致。若把部分通过视为未通过，则计入分母、不计入分子；若视为通过，则同时计入分子和分母，并在报告中单独标注部分通过的数量。两种处理会让通过率出现明显差异，同一版本的多份报告应使用同一规则。
同一用例在一轮测试里重跑多次，通过率会怎么变化？
按执行记录计数时，重跑会放大分母，可能拉低通过率；按用例计数并取最后一次有效结果，则一条用例只计一次。口径中应明确采用哪种粒度，并规定重跑历史记录留存但不参与计算。若补测发生在下一轮次，应归入实际执行所在轮次，并在报告中说明跨轮补测情况。
分母为零或有效执行数很少时，报告里怎么展示？
分母为零时标注“无有效执行”，避免显示为 0% 被误读为全部失败。有效执行数过少时，建议同时给出绝对数量和样本量提示，说明该数值参考价值有限。这类展示规则也应写入口径说明，保证不同轮次的报告呈现方式一致。
通过率口径调整后，历史数据还能直接比较吗？
口径变更会改变数值的可比性。建议记录变更时间、变更原因和影响范围，在历史数据上标注是否可比；必要时用新旧两套口径对同一批数据各算一次，给出差异说明。跨版本比较还需确认用例集范围、用例设计标准和统计时间窗长度一致。
在测试管理工具里怎么让通过率取数可重复？
把版本、轮次设为可筛选的用例属性，将取数条件固化为筛选器，每次按同一条件导出执行明细。ONES 测试管理支持用例属性自定义、用例库属性筛选，也支持用例导入导出，便于导出明细后与报告数值逐条核对；测试情况概览可查看测试计划的进度和通过率，测试报告支持自定义组装模板。具体通过率字段的默认计算规则以实际配置为准，口径说明中应写明本团队采用的分子分母定义。
