公共测试用例清单把跨项目可复用的测试用例集中到一张表里，让不同团队在编写、评审和执行时使用同一套字段口径。本文提供一张可直接复制到表格工具的空白模板，并逐字段说明填写方法、必填与选填的划分、一条完整填写示例，以及清单随项目演进时的维护规则。模板覆盖用例编号、所属模块、用例标题、前置条件、操作步骤、预期结果、优先级、用例类型、适用版本、复用范围、维护人和更新时间十二个字段。
要点总览（TL;DR）
- 公共测试用例清单是一张跨项目共享的用例资产表，本文提供可直接复制的十二字段空白模板，覆盖编号、模块、标题、前置条件、步骤、预期结果、优先级、类型、适用版本、复用范围、维护人与更新时间。
- 必填项包括用例编号、所属模块、用例标题、前置条件、操作步骤、预期结果、优先级、维护人和更新时间；用例类型、适用版本、复用范围可先留空，在评审或复用确认时补齐。
- 填写时先固定编号与模块命名口径，步骤按编号书写并与预期结果逐条对应，适用版本管版本范围、复用范围管使用方，两列分开填写。
- 清单维护围绕新增查重、废弃保留编号、字段变更评审和按版本周期清理归档展开，避免字段口径漂移和用例长期不更新。
- 清单规模扩大、多人同时编辑时，可考虑迁移到支持用例库、自定义属性和权限配置的测试管理工具中继续维护。
可复制空白模板：公共测试用例清单表
下面这张表可以直接复制到 Excel、在线表格或测试管理工具中。表头保持固定顺序，新增行时按列填写即可。空白行给出三行，实际使用时按需增删。
| 用例编号 | 所属模块 | 用例标题 | 前置条件 | 操作步骤 | 预期结果 | 优先级 | 用例类型 | 适用版本 | 复用范围 | 维护人 | 更新时间 |
|---|---|---|---|---|---|---|---|---|---|---|---|
复制时建议保留表头行并冻结，避免滚动后列含义错位。如果团队已有测试管理工具，可先按此表头整理存量用例，再批量导入，减少逐条录入的成本。
字段说明：每个字段填什么、怎么填
字段口径统一，清单才能被不同角色读懂。下表逐列说明含义与填写方式，重点区分容易混淆的几组字段。
| 字段 | 填写内容 | 填写口径 |
|---|---|---|
| 用例编号 | 唯一标识 | 采用“模块缩写-三位序号”格式，如 LOGIN-001；编号一经分配不再复用，废弃用例的编号保留并标记状态 |
| 所属模块 | 用例归属的功能模块 | 使用团队统一的功能树名称，如“登录”“订单-退款”；层级用短横线连接，避免同一模块出现多种叫法 |
| 用例标题 | 一句话说明验证点 | 写成“条件+动作+结果”的短句，如“错误密码连续输入五次后锁定账户”，标题内不写步骤 |
| 前置条件 | 执行前需具备的状态 | 写清账号、数据、配置和环境，如“已注册且未锁定的普通用户账号一个”；无特殊条件时填“无” |
| 操作步骤 | 可照着执行的动作序列 | 按 1、2、3 编号，每步一个动作，包含输入的具体数据；步骤数量与预期结果条目对应 |
| 预期结果 | 每步或整体应出现的结果 | 与步骤编号一一对应，描述可观察的界面反馈、数据变化或提示文案，避免“正常”“成功”这类无法核验的表述 |
| 优先级 | 执行先后与回归取舍依据 | 用 P0–P3 四级：P0 为核心主流程，P1 为重要分支，P2 为一般功能，P3 为边界与低频场景 |
| 用例类型 | 用例的性质分类 | 从功能、接口、兼容性、性能、安全等固定选项中选取，便于按类型筛选回归范围 |
| 适用版本 | 该用例对应的产品版本范围 | 写版本号或区间，如“V3.2 及以上”；版本升级导致行为变化时同步更新此列 |
| 复用范围 | 可被哪些项目或团队引用 | 写项目名、产品线或“全公司通用”；与适用版本配合使用，前者管版本，后者管使用方 |
| 维护人 | 对该条用例负责的人 | 填具体姓名或工号，不填团队名；人员变动时及时移交 |
| 更新时间 | 最近一次修改日期 | 统一格式如 YYYY-MM-DD，每次修改内容后同步更新，用于识别长期未维护的用例 |
其中“适用版本”和“复用范围”最容易被混填。适用版本回答“这条用例在哪些版本上有效”，复用范围回答“哪些项目可以直接拿来用”。一条用例可以适用多个版本，但只对部分项目开放复用，两列需要分别填写。
必填与选填：哪些字段不能空
必填项决定一条用例能否被他人独立执行和检索，选填项用于补充管理信息。建议按下表划分，团队可在评审时按实际情况微调，但调整后需在清单说明中同步。
| 类别 | 字段 | 理由 |
|---|---|---|
| 必填 | 用例编号、所属模块、用例标题、前置条件、操作步骤、预期结果、优先级、维护人、更新时间 | 缺少编号无法引用，缺少模块无法归类，缺少步骤与预期结果无法执行，缺少优先级无法安排回归，缺少维护人和时间无法追责与识别陈旧用例 |
| 选填 | 用例类型、适用版本、复用范围 | 新建用例初期可能尚未确定适用版本和复用项目；用例类型可在评审时补充。这三项为空不影响用例被执行，但会影响筛选和复用效率 |
必填项缺失时的处理方式：录入阶段由填写人补齐后再提交评审；评审阶段发现缺失，退回补充而不是由评审人代填，保证责任清晰。历史存量用例批量导入时，可先允许选填项为空，但必填项缺失的记录单独列出，设定一个清理周期集中补齐。前置条件确实不存在的，填“无”，不留空，以便区分“没有条件”和“忘记填写”。
填写示例：一条完整用例如何落到清单里
以下示例为演示情景，展示各字段之间的对应关系。步骤与预期结果按编号一一对应，复用范围和适用版本分别填写。
| 字段 | 填写内容 |
|---|---|
| 用例编号 | LOGIN-003 |
| 所属模块 | 登录-密码校验 |
| 用例标题 | 错误密码连续输入五次后锁定账户 |
| 前置条件 | 已注册且状态正常的普通用户账号一个，当前未处于锁定状态 |
| 操作步骤 | 1. 打开登录页，输入该账号与错误密码，点击登录；2. 重复第 1 步共五次；3. 第六次输入正确密码，点击登录 |
| 预期结果 | 1. 提示“账号或密码错误”，页面停留在登录页；2. 第五次失败后提示“账号已锁定，请 30 分钟后重试”；3. 登录失败，仍提示账号已锁定 |
| 优先级 | P1 |
| 用例类型 | 功能 |
| 适用版本 | V3.2 及以上 |
| 复用范围 | 用户中心项目、门户项目 |
| 维护人 | 张明 |
| 更新时间 | 2025-03-14 |
这条示例体现了几个填写要点：步骤中的“五次”“30 分钟”是具体数据，执行人不需要再猜测；预期结果按步骤编号对应，第三步验证的是锁定状态持续生效；适用版本写区间，复用范围写具体项目，两者共同界定这条用例能被谁在什么版本上使用。团队新增用例时，可先照此示例填一条，确认口径一致后再批量录入。
调整与维护方法：清单如何随项目演进
清单建立后，主要风险是字段口径漂移和用例长期不更新。维护规则应覆盖新增、废弃、字段变更和定期清理四类动作。
新增与废弃用例
- 新增用例先查重：按所属模块和标题关键词检索，已有相似用例时优先补充原用例的步骤或适用版本，避免同一验证点出现多条。
- 编号按模块顺序递增分配，不复用已废弃编号；废弃用例保留行，在标题前加“【已废弃】”标记，并注明废弃原因和替代用例编号。
- 用例因需求下线而失效时，由维护人在评审中确认后标记废弃，不直接删除行，保留追溯线索。
字段增删的评审方式
- 字段调整由测试负责人发起，说明新增字段的用途、填写口径和对存量数据的影响，经测试团队评审后统一修改表头。
- 新增字段先设为选填，运行一个版本周期后再评估是否转为必填，避免一次性抬高录入成本。
- 字段改名时同步更新字段说明文档和导入模板，防止旧模板导入后列错位。
定期清理与归档
- 每个版本周期结束时，按“更新时间”筛选超过两个版本未修改的用例，由维护人确认是否仍然有效。
- 连续两个版本未执行且无复用记录的用例，移入归档区单独存放，主清单只保留活跃用例。
- 归档清单按季度打包留存，注明归档时间和覆盖版本，需要时可按编号检索恢复。
当清单规模扩大、多人同时编辑时，表格工具的版本冲突和权限控制会成为维护难点。ONES 测试管理支持编写测试用例并组织用例库，用例模块采用树状结构并可拖拽排序，便于按模块归类；支持自定义用例属性，可以把本文的优先级、用例类型、适用版本等字段配置为用例属性；支持从 Excel 表批量导入用例并在线管理，也支持导出和本地备份，适合把存量清单迁移到统一用例库后继续维护。对于需要区分编辑与查看权限的团队，ONES 支持为不同用户组配置权限，并可为用例库单独配置权限，让维护人负责内容更新、其他成员以引用为主。是否迁移取决于团队规模与协作频率，单人或短期项目继续使用共享表格也能满足基本需求。
常见问题
公共测试用例清单和单个项目的测试用例表有什么区别？
单个项目的用例表服务于一个项目的测试执行，字段和编号通常按项目内部习惯设定。公共测试用例清单面向多个项目共享，字段口径需要跨团队一致，因此额外强调复用范围和适用版本：前者说明哪些项目可以直接引用，后者说明这条用例在哪些产品版本上有效。清单里的用例应当是可被其他团队独立执行的，前置条件、步骤和预期结果要写到不需要原编写人在场也能照做的程度。
存量用例批量导入时，必填项缺失怎么处理？
建议把必填项缺失的记录单独列成一张待补清单，而不是在导入时由他人代填。可以先完成导入，让用例进入统一库中可检索，再设定一个清理周期集中补齐。补齐时优先处理高优先级用例，因为这类用例在回归中被引用的频率更高。前置条件确实不存在的填“无”，与“忘记填写”区分开，便于后续筛查。
用例类型、适用版本、复用范围设为选填，会不会影响清单的复用效果？
会有影响，但影响集中在筛选和复用环节，不影响用例被执行。这三项为空时，其他团队难以判断一条用例是否适用于自己的项目和版本，检索成本会上升。可行的做法是：新建用例时允许为空，在用例首次被其他项目引用前必须补齐适用版本和复用范围，用例类型在评审时统一补全。这样既控制了录入初期的负担，也保证复用发生时信息完整。
清单里的用例多久清理一次比较合适？
清理节奏可以跟团队的版本周期绑定，每个版本周期结束时按更新时间筛查一次，把超过两个版本未修改的用例交给维护人确认。连续两个版本未执行且没有复用记录的用例移入归档区，主清单只保留活跃用例。归档不等于删除，按季度打包留存并注明覆盖版本，需要时仍可按编号检索恢复。团队版本节奏较慢时，也可以按季度固定清理，关键是节奏稳定、责任到人。
把表格清单迁移到测试管理工具时，需要提前准备什么？
先确认表头字段与工具中的用例属性能够对应，尤其是优先级、用例类型这类有固定选项的字段，需要提前把选项值对齐，避免导入后出现同一含义的多种写法。其次确认模块层级如何映射到工具的用例目录结构。ONES 测试管理支持从 Excel 表批量导入用例，用例模块采用树状结构并可拖拽排序，也支持自定义用例属性，可以把清单中的优先级、用例类型、适用版本配置为属性；同时支持为不同用户组和用例库单独配置权限，便于区分维护人与引用者。迁移前建议先用少量用例试导一次，核对字段落位后再批量执行。
