
在禅道里,测试单关联用例要解决三件事:确定这一轮执行哪些用例、把执行结果记在这张测试单上、让失败项以带来源的Bug进入修复流程。关联不是把用例复制进测试单,而是引用产品用例的某个版本。
三件事经常被混在一起:范围没定清楚,测试单越建越大;执行入口选错,结果没有落到测试单;失败后直接提Bug,来源用例为空,测试报告里的数据对不上。下面按一条完整链路拆开讲。
测试单和用例是什么关系
测试单是一次测试任务的执行记录。它有明确的构建、负责人、起止时间和用例范围,回答的是"这个版本测了什么、结果如何"。用例属于产品,是长期维护的资产,可以在多个测试单里反复使用。
测试单关联用例时,引用的是用例版本,不是复制一份新用例。关联那一刻确定版本,之后用例再修改,测试单不会自动跟着变;需要重新确认更新,否则执行的仍是关联时的步骤和预期。反过来,一份用例被多个测试单引用,各测试单的执行结果互不影响,这正对应一轮测试建一张测试单的做法。
有一个来源限制需要先知道:测试单关联的是产品下的用例。公共用例库里的用例要先导入产品用例列表,才能在关联页被选中。用例本身的写法、步骤与预期结果设置,可以参考创建测试用例。

关联之前先确认三件事
关联页只解决"选哪些"。选不到用例,往往不是操作问题,而是前置数据没准备好。动手前核对三项。
- 构建已创建并提交测试。测试单从构建发起,构建上关联了需求,后面才能按构建关联的需求快速筛出用例。构建没准备好,范围只能靠手工勾选,容易漏。
- 用例已在产品下可用。确认产品、模块正确,关键用例已关联研发需求。用例是否通过评审不影响关联,但会影响预期结果能否作为判定依据。
- 人与权限到位。测试单负责人、执行人明确,执行人有权进入测试单并执行用例。人没指派,测试单会显示有范围、没人动。
三项里缺任何一项,后面都要补做一遍,范围与结果的可解释性也会打折。
测试单如何关联用例
入口在测试单列表:找到本轮测试单,点操作里的"关联用例",进入用例选择页。完整流程可参考官方文档中的提交测试单。
- 先用构建和需求缩范围。关联页支持按测试单所关联构建下的需求检索用例,把"这版改了什么"直接映射成用例集合。
- 再用套件或模块收敛。冒烟、回归这类固定组合用测试套件筛选更快;只测某个功能域时按模块勾选。
- 关键字定位单条。补测、验证历史问题时,用标题关键字或编号找到目标用例。
- 确认版本再提交。列表默认取用例的最新版本,需要复现历史问题时可以切到之前的版本。勾选完成后保存。
- 回到测试单的"用例"页核对。看总数、模块分布、执行人三列,确认没有漏选或多选,再批量指派给执行人。
判断关联是否成功,不看提示语,看测试单用例页:数量与预期一致、用例版本正确、每条都有执行人。三项都对,才进入执行。

执行范围怎么定
范围不是越多越好,它要能回答一个具体问题:这个构建能不能发。由此倒推,范围由两部分组成,本次变更直接影响的用例,以及变更可能波及的相邻功能用例。
按来源选圈定方式,比按习惯全选更稳。
四种圈定方式可以组合使用,关键是每种都能说清为什么在这个范围里。
| 圈定方式 | 适用场景 | 主要风险 |
|---|---|---|
| 需求锚定 | 迭代内有明确需求变更,按构建关联需求筛用例 | 需求与用例未关联时会漏 |
| 套件锚定 | 冒烟、回归、专项测试有固定组合 | 套件长期不维护会带入失效用例 |
| 模块锚定 | 新功能集中在少数模块,按模块勾选 | 跨模块影响容易漏 |
| 关键字与单条补录 | Bug验证、临时补测、历史问题复现 | 依赖个人记忆,范围难解释 |
需求锚定适合做主干,套件与模块做补充,关键字只用于兜底。组合之后,范围仍要能一句话解释给开发和产品。
三条边界比技巧更重要:
- 一轮测试一张测试单。不同构建、不同轮次的执行结果需要分开看;混在一张单里,进度和结论都会失真。
- 只关联本轮确实要执行的用例。为了"覆盖全"把全量用例塞进来,未执行项会一直挂在进度里,测试单迟迟关不掉。
- 本轮不测但已关联的用例,执行时选"忽略"并写原因。它比直接不记录更容易解释,也保留了评估过、决定不测的证据。
范围定完,在提测时和开发、产品对一次需求清单。测试单的范围与提测说明对得上,后面讨论能不能发才有共同依据。

执行结果怎么回写
执行入口决定结果记在哪。推荐在测试单的"用例"页逐条执行,或勾选后批量执行,这样结果归属这张测试单,测试单状态、进度和统计才会更新。禅道21.4版本起,测试单中执行用例后会自动更新测试单状态。在产品的用例列表里单独执行,更新的是用例自身的执行记录,不会替你推进测试单。
每次执行要记录四类信息:
- 执行结果。通过、失败、阻塞、忽略。失败表示实际结果与预期不符;阻塞表示环境、数据或依赖导致无法判定;忽略表示本轮明确不执行。
- 步骤结果与实际结果。用例按步骤记录时,逐步标记并写下实际现象,后面复现和转Bug都靠它。
- 结果备注与附件。日志、截图、请求响应放在这里,比留在聊天记录里更耐久。
- 失败项的Bug。结果失败时可以直接转Bug,勾选失败步骤后重现步骤会自动带入;也可以在提Bug页面选择来源用例。这个关联决定了测试报告里的数据是否完整。
一次执行的结果会写到四个地方,各有用途。
| 去向 | 记录内容 | 用途 |
|---|---|---|
| 测试单 | 本轮状态、执行进度、通过失败统计 | 判断这个构建能不能发 |
| 用例 | 最近执行结果、执行次数、历史记录 | 看这条用例长期是否稳定 |
| Bug | 来源用例、失败步骤、复现信息 | 修复与回归时追溯原始场景 |
| 测试报告 | 范围、轮次、关联用例、遗留Bug | 对外说明测试结论与风险 |
这四个去向不是重复记录,而是同一份结果在不同决策场景下的视图。回写完整时,测试报告不需要人工再拼数据;回写缺失时,报告里的Bug数、通过率就会对不上。
多轮测试要新建测试单。同一批用例在不同测试单里的执行结果相互独立,用例侧则保留每次执行的记录,既能看单轮结论,也能看一条用例跨版本的表现。执行界面的细节见执行用例。

常见问题
同一条用例能关联到多个测试单吗?
可以。各测试单的结果独立记录,用例侧累计执行次数与执行历史。回归、验收分别建单,比在一张单里反复执行更清楚。
关联错了怎么撤销?
在测试单的用例页取消关联即可。已经产生的执行记录不会随之消失,重新关联前先确认是否需要保留原结果。
测试报告里的Bug数为什么是0?
通常是Bug没有关联来源用例,或统计口径没对上。提Bug时选择来源用例,事后也可以在Bug详情里补充关联,再看报告。
执行结果能批量导入吗?
禅道不支持用CSV导入执行结果,批量场景可以通过接口写入。使用前先确认字段、权限和执行人归属,避免结果落到错误的测试单。
收尾:一轮测试的检查清单
把流程压成一张检查表,每次提测照着走一遍。
- 关联前:构建已提交测试,需求与用例已建立关联。
- 关联后:用例数量、版本、执行人三项与预期一致。
- 执行中:在测试单内执行,失败项带步骤转Bug。
- 关闭前:没有遗留的未执行用例,忽略项都有原因。
- 出报告:测试单关联报告,遗留Bug与风险写清楚。
据51Testing《2025年软件测试行业现状调查报告》,禅道在常用测试管理工具中连续11年位列第一。工具被广泛使用,流程差异反而更值得对齐:关联决定范围,执行决定数据,回写决定这份测试结论能不能被追溯。
参考资料
- 51Testing软件测试网,《2025年软件测试行业现状调查报告》,https://www.51testing.com/
- 禅道官方文档,提交测试单,https://www.zentao.net/book/zentaopms/1490.html
- 禅道官方文档,执行用例,https://www.zentao.net/book/zentaopms/896.html
- 禅道官方文档,创建测试用例,https://www.zentao.net/book/zentaopms/108.html
文章标题 :测试单如何关联用例?执行范围与结果回写 ,发布者 :项目管理研究院


































