测试用例复用率统计口径怎么定:分子、分母与时间窗

确定测试用例复用率的统计口径,核心是把三件事定清楚:复用怎么算(分子)、统计对象是什么(分母)、在哪个时间窗和用例库范围内统计。常用口径是“统计期内被复用到至少一次执行或引用中的用例数 ÷ 统计期内用例库中有效用例总数”,同时明确去重规则、跨项目引用是否计入、新建与废弃用例如何处理。口径确定后,应连同公式、单位、分母为零的处理方式和示例写入指标说明,让不同团队算出的数可以复算、可以比较。



要点总览(TL;DR)


  • 复用率口径要先定三件事:复用怎么算(分子)、统计对象是什么(分母)、在哪个时间窗和用例库范围内统计。
  • 常用公式:统计期内被复用到至少一次执行或引用的用例数 ÷ 统计期内用例库中有效用例总数 × 100%,分子按用例ID去重。
  • 跨项目引用是否计入、草稿与废弃用例是否排除,必须在指标说明中写死;示例中仅因跨项目引用口径不同,结果可相差5个百分点。
  • 数据取自用例管理工具的执行记录与引用关系,无记录视为未复用,执行记录整体缺失应标注数据不完整而非计为零。
  • 复用率只反映复用广度,需与执行通过率、缺陷发现数等组合解读,口径变更要记录版本后再做跨期比较。


评估目标:复用率要回答什么问题


复用率首先是一个资产层面的观察指标,用来判断用例库里的用例是否被重复使用、用例库的建设和维护投入是否产生了复用价值。它回答的问题是:我们积累的用例,有多少在后续的测试活动中被再次用到。这个判断服务于用例库治理,比如决定哪些模块值得继续沉淀、哪些用例长期无人使用需要清理或重构。


用途不同,口径设计会明显不同。用于资产复用评估时,统计对象是整个用例库,关注库整体的复用广度;用于个人产出考核时,容易诱导测试人员为了数字去刷引用记录,比如把用例复制到多个计划里制造“被引用”的假象。因此建议把复用率定位为库级评估指标,个人层面如需使用,应配合引用来源、执行结果等明细一起看,避免单一数字直接对应绩效。


评估周期和责任角色也要提前定。常见做法是按季度或按版本周期统计,周期太短会让新用例来不及被复用,周期太长则难以及时发现资产闲置。责任分工上,测试负责人确定口径和解读规则,用例库管理员维护用例状态、归属项目和引用记录,保证数据源本身干净。两者职责分开,口径才不会被数据维护的随意性带偏。



指标与范围:分子、分母和统计边界


分子和分母的定义决定了这个指标能不能复算。分子是统计期内被复用到至少一次执行或引用中的用例数,按用例去重,同一条用例在一个统计期内被引用十次也只计一次。分母是统计期内用例库中处于有效状态的用例总数。两个数都以“用例”为单位,而不是以引用次数或执行次数为单位,这样指标反映的是复用广度,不会因为某条用例被高频调用而虚高。


范围边界要在指标说明里逐项写清。项目范围上,明确纳入哪些项目或产品线的用例库;用例类型上,说明功能用例、接口用例、回归用例是否都纳入,还是只统计某一类;跨项目引用上,要明确其他项目引用本库用例是否计入分子。跨项目引用通常是复用价值的重要来源,但它的数据记录方式依赖工具支持,如果引用关系没有被系统记录,就只能靠人工登记,这时要么缩小范围只统计同项目复用,要么单独说明数据来源。


排除项同样需要写进定义。草稿状态的用例尚未定稿,不进入分母;已废弃或归档的用例不再具备复用价值,也不进入分母;仅在用例库内被复制、没有实际执行或引用的用例,不能算作复用。下面这张表可以作为指标说明的模板。


项目 定义
指标名称 测试用例复用率
公式 统计期内被复用到至少一次执行或引用的用例数 ÷ 统计期内用例库中有效用例总数 × 100%
单位 百分比,保留一位小数
分子 统计期内有执行记录或引用记录的用例,按用例ID去重
分母 统计期内处于有效状态的用例总数,排除草稿与已废弃用例
纳入范围 指定项目/产品线的用例库;功能、接口、回归等指定用例类型;跨项目引用按约定计入或排除
排除范围 草稿、已废弃、仅复制未实际使用的用例
时间窗 按季度或版本周期,起止日期明确到日


数据口径:字段、来源与缺失值处理


算复用率至少需要几类字段:用例ID、所属项目、用例状态、创建时间,以及被引用或被执行的相关记录。用例ID是去重的依据,必须保证全库唯一;所属项目决定统计范围;状态字段用来筛出有效用例;创建时间用于判断用例是否在统计期内已经存在。引用和执行记录则用来判断某条用例在统计期内是否被再次使用。


数据来源主要来自用例管理工具的执行记录和引用关系。执行记录通常随测试计划的执行产生,引用关系则体现在用例被关联到其他测试计划、需求或任务中。取数时先导出原始记录,再按用例ID去重,避免同一条用例因多次执行被重复计数。如果引用关系在工具里没有结构化记录,需要约定人工登记的方式和登记字段,否则这部分数据无法稳定进入分子。


缺失值要区分情况处理。某条用例在统计期内没有任何引用或执行记录,视为未复用,计入分母但不计入分子,这是正常的数据状态。执行记录整体缺失,比如某个项目没有在工具中执行测试,则应把该项目标注为数据不完整,在报告中单独说明,不能直接当作零复用计入,否则会拉低整体数字并误导判断。跨系统数据不一致时,需要事先约定以哪个系统为准,通常以承载用例主数据和执行记录的系统为准,另一个系统的数据仅作补充核对。


把用例、执行记录和状态字段沉淀在同一个管理工具里,取数会稳定很多。ONES 测试管理支持编写测试用例、组织用例库,用例与产品需求、研发任务可以关联,测试计划执行时可分配用例执行人,用例库中的用例属性支持筛选,也提供质量统计报表和测试报告。这些数据为按项目、按状态、按时间窗筛选有效用例和复用记录提供了基础。需要说明的是,复用率的专用字段或内置报表是否提供,要以具体版本的实际情况为准,口径设计本身不依赖某个特定报表。



计算步骤:从原始数据到复用率


口径确定后,计算可以拆成四步,每一步都留下可核对的中间结果,方便他人复算。


  1. 按时间窗筛出有效用例集合,得到分母。取统计期起止日期内、处于有效状态、属于约定项目和用例类型的用例,按用例ID去重计数。
  2. 筛出统计期内有执行或引用记录的用例,按用例ID去重得到分子。只保留同时满足“在分母集合内”和“统计期内有至少一次执行或引用”的用例。
  3. 计算复用率 = 分子 ÷ 分母 × 100%,结果保留一位小数。同时记录分子、分母的原始数量和取数日期。
  4. 分母为零时输出“不适用”,不输出0%或100%。分母为零说明统计范围内没有有效用例,此时任何百分比都没有意义,应检查范围设置或数据是否完整。

建议在指标说明中附上取数脚本或筛选条件的文字描述,并记录每次统计的口径版本号。口径一旦调整,比如新增了跨项目引用,版本号随之变化,跨期比较前先确认两期口径一致。



例子:一个季度口径的完整演算


以下为演示情景,数字仅用于说明计算过程,不代表任何真实团队数据或行业水平。某季度,约定统计范围内用例库共有有效用例1200条,作为分母。按用例ID去重后,统计期内有执行记录或引用记录的用例共420条,作为分子。复用率 = 420 ÷ 1200 × 100% = 35.0%。


范围定义对结果的影响可以用同一组数据对比。如果口径规定跨项目引用不计入分子,而420条中有60条属于其他项目引用本库用例,那么分子变为360条,复用率 = 360 ÷ 1200 × 100% = 30.0%。同一季度、同一个库,仅因跨项目引用是否计入,结果相差5个百分点。这说明范围边界必须在指标说明中写死,否则不同团队各按各的理解取数,数字无法横向比较。


还要注意这个数字的含义。35.0%反映的是统计期内有超过三分之一的用例被再次使用,说明的是复用广度;它不说明这些被复用的用例质量如何,也不说明复用带来了多少缺陷发现或节省了多少执行时间。解读时应把它当作资产活跃度的信号,而不是质量结论。



解读与限制:复用率不能单独说明什么


复用率高不等于用例质量高。一个库里的用例如果被反复引用,但引用的都是低价值、覆盖面窄的用例,复用率好看却对测试有效性帮助有限。反过来,复用率低也不等于资产浪费。新业务或新模块处于快速迭代阶段,用例天然以新建为主,复用机会少,这时低复用率是阶段特征,不宜直接判定为用例库建设失败。


建议把复用率与用例执行通过率、缺陷发现数、用例维护成本等指标组合解读。复用率说明用例被再次使用的广度,执行通过率反映用例在当前版本下的有效性,缺陷发现数反映用例的检出能力,几项放在一起才能判断用例库的整体健康度。单看复用率容易得出片面结论。


口径变更必须记录版本。调整分子定义、纳入范围或时间窗后,新旧两期的数字不具备直接可比性,跨期比较前先确认口径一致,或在报告中同时标注口径版本。复用率是一个管理观察工具,它的价值来自口径稳定和解读克制,而不是数字本身的高低。



常见问题


统计期内新建的用例,应该计入分母吗?


可以计入,但要先约定一个观察条件。新建用例在统计期内已经存在、状态有效,就属于用例库的有效资产,计入分母;它如果在统计期内被其他计划引用或执行过,也计入分子。问题在于统计期末尾新建的用例几乎没有机会被复用,会系统性拉低复用率。常见处理是只统计统计期开始前已创建、或在统计期内已存在超过约定天数的用例,并在指标说明中写明这条时间条件,保证各期算法一致。


工具里没有结构化的引用记录,跨项目复用还能统计吗?


可以统计,但需要补充人工登记。跨项目引用如果只体现在沟通记录或文档里,工具无法自动汇总,此时要么缩小口径只统计同项目复用,要么约定登记字段(用例ID、引用项目、引用日期、引用方式),由用例库管理员定期汇总后并入分子。两种做法都要在指标说明中注明数据来源,避免把人工登记的数据和系统记录的数据混在一起比较。ONES 测试管理支持用例与产品需求、研发任务关联,用例属性支持筛选,可作为引用关系沉淀的基础;跨项目引用是否被系统记录并可统计,需以具体版本实际情况为准。


同一个用例在一个季度里被引用多次,分子要按次数算吗?


不按次数算。复用率的统计单位是用例,分子按用例ID去重,同一条用例在一个统计期内被引用十次也只计一次。按次数计算会让高频调用的少数用例主导指标,反映的是调用强度而非资产复用广度。如果团队确实关心调用强度,可以另设“人均引用次数”或“用例平均被引用次数”作为辅助指标,与复用率并列展示,但不要混入同一个公式。


分母为零时为什么不能写0%?


分母为零说明统计范围内没有有效用例,此时百分比没有计算基础。写0%会被误读为“有资产但完全没复用”,写100%更会误导。规范做法是输出“不适用”,并附上原因说明,比如范围设置过窄、状态筛选条件有误或数据尚未导入。同时应检查取数流程,确认是统计范围问题还是数据完整性问题,修正后再重新计算。


口径调整后,历史数据还能直接对比吗?


不能直接对比。分子定义、纳入范围或时间窗任何一项变化,都会改变计算结果,新旧两期的数字不在同一基准上。建议为每次口径调整记录版本号和变更内容,跨期比较前先确认两期口径一致;如果必须展示趋势,可以在报告中同时标注口径版本,或按新口径回溯重算历史数据后再比较。口径稳定的时间越长,复用率的参考价值越高。