测试用例库目录是一张以用例为行、以字段为列的台账，用来回答“这条用例是什么、属于哪里、怎么执行、能否复用、由谁维护”。一份可用的目录通常包含标识与归属、设计与执行要素、资产复用信息、维护责任四组字段。下面先给出可直接复制到表格工具中的空白模板，再逐项说明字段含义、必填规则、完整填写示例和后续维护方法。目录中的版本、评审状态等字段，也可以在ONES测试管理的用例库工作中承载。
要点总览（TL;DR）
- 测试用例库目录按四组字段组织：标识与归属、设计与执行要素、资产复用信息、维护责任，共18列，可直接复制到表格工具使用。
- 必填字段包括用例编号、标题、所属模块、操作步骤、预期结果、优先级和负责人；目录路径、关联需求、前置条件等按触发条件填写。
- 一条完整记录应写清编号规则、三级目录路径、可观察的预期结果、复用范围与版本变更记录，示例中演示了各字段的填法。
- 目录维护围绕字段增删试运行、模块树层级控制、版本递增与季度清理展开，占位写法需团队统一并定期清理。
- 迁移到测试管理工具时，模块树、自定义属性和需求关联可承接目录字段，ONES测试管理支持用例库组织、自定义属性与需求关联。
可复制的测试用例库目录空白模板
将下表复制到Excel、在线表格或测试管理工具的自定义字段中即可开始填写。列按四组字段分区排列，组内顺序与后文说明一致。第一行是列名，第二行起为空白记录行，可按需向下复制。
| 标识与归属 | 设计与执行要素 | 资产复用信息 | 维护责任 | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 用例编号 | 用例标题 | 所属模块 | 目录路径 | 关联需求 | 前置条件 | 操作步骤 | 预期结果 | 优先级 | 用例类型 | 复用范围 | 关联用例 | 用例版本 | 变更记录 | 负责人 | 评审状态 | 更新时间 | 备注 |
如果团队使用在线表格，建议把“操作步骤”和“预期结果”两列设为较宽列或允许换行，步骤较多时按“1. 2. 3.”分行书写。若在测试管理工具中建库，可把上述列名映射为自定义属性，模块与目录路径对应工具中的树状目录结构。
目录字段说明：每个字段记录什么
字段说明的作用是让填写者理解每个格子记录的业务信息，避免把目录填成只有标题的清单。下表按四组字段逐一解释含义与取值方式。
| 分组 | 字段名 | 记录什么 | 取值示例 |
|---|---|---|---|
| 标识与归属 | 用例编号 | 用例在库内的唯一标识，便于引用、关联缺陷和跨文档检索 | TC-LOGIN-001 |
| 用例标题 | 一句话说明验证对象与验证点，能独立读懂 | 手机号加验证码登录成功 | |
| 所属模块 | 用例对应的产品功能模块，作为目录树的一级分类 | 账号与登录 | |
| 目录路径 | 从库根到当前用例的完整层级，标明用例在库中的位置 | 账号与登录/登录方式/验证码登录 | |
| 关联需求 | 用例覆盖的需求编号或需求标题，用于追溯覆盖情况 | REQ-2024-118 登录方式扩展 | |
| 设计与执行要素 | 前置条件 | 执行前需要具备的数据、账号、环境或状态 | 已注册手机号，验证码服务可用 |
| 操作步骤 | 按顺序编号的操作动作，每步一个动作 | 1. 打开登录页 2. 输入手机号 3. 获取并输入验证码 4. 点击登录 | |
| 预期结果 | 与步骤对应的可观察结果，尽量写具体页面状态或数据变化 | 跳转至首页，右上角显示当前手机号 | |
| 优先级 | 用例的重要程度，用于确定执行顺序和回归范围 | P1 | |
| 用例类型 | 用例所属的测试类别，便于按类型筛选和统计 | 功能测试 | |
| 资产复用信息 | 复用范围 | 该用例可被哪些项目、版本或测试计划复用 | 主站App 3.x 全版本回归 |
| 关联用例 | 与本用例存在依赖、前置或替代关系的其他用例编号 | TC-LOGIN-002（密码登录） | |
| 用例版本 | 用例内容当前的版本号，内容修改后递增 | V1.2 | |
| 变更记录 | 简要记录本次修改内容、修改人和日期 | V1.2 2024-06-12 新增验证码错误分支 | |
| 维护责任 | 负责人 | 对该用例内容准确性和更新负责的人 | 张敏 |
| 评审状态 | 用例是否经过评审及当前状态 | 已评审 | |
| 更新时间 | 最近一次修改该用例的日期 | 2024-06-12 | |
| 备注 | 补充说明，如已知限制、环境依赖、待确认问题 | 依赖短信通道测试环境 |
四组字段各自承担不同职责：标识与归属解决“找得到、追得回”，设计与执行要素解决“照着能执行”，复用与版本解决“能不能被别的项目拿来用、改动是否可追溯”，维护责任解决“谁来保证内容不过期”。填写时先保证前两组完整，再补充后两组。
必填与选填：哪些字段不能空
必填字段的划分依据是：缺少该信息会导致用例无法被识别、无法执行或无法追溯。以下规则是模板使用建议，团队可以按自身评审要求和合规要求调整，但调整后应在库内统一执行。
| 字段 | 填写要求 | 理由或触发条件 |
|---|---|---|
| 用例编号 | 必填 | 唯一标识，缺失会导致引用和关联失效 |
| 用例标题 | 必填 | 检索和评审的第一入口 |
| 所属模块 | 必填 | 决定用例在目录树中的位置 |
| 操作步骤 | 必填 | 缺少步骤则用例无法执行 |
| 预期结果 | 必填 | 缺少预期结果无法判断通过与否 |
| 优先级 | 必填 | 影响回归范围和执行排序 |
| 负责人 | 必填 | 明确维护责任人，避免用例长期无人更新 |
| 目录路径 | 条件必填 | 目录层级超过两级时填写完整路径；单层目录可只填所属模块 |
| 关联需求 | 条件必填 | 需求驱动型项目应填写；探索性测试或通用基础用例可标注“通用” |
| 前置条件 | 条件必填 | 执行依赖特定数据、账号或环境时必填；无特殊依赖时写“无” |
| 用例类型 | 条件必填 | 库内存在多类测试（功能、接口、性能）时必填，便于分类统计 |
| 复用范围 | 条件必填 | 用例被多个项目或版本共用时填写；仅服务单一版本时可留空 |
| 用例版本 | 条件必填 | 用例进入正式评审或基线后填写，初始可写V1.0 |
| 评审状态 | 条件必填 | 团队执行用例评审流程时必填，否则可省略该列 |
| 关联用例 | 选填 | 存在依赖、前置或替代关系时填写 |
| 变更记录 | 选填 | 内容发生修改时补充，首次创建可留空 |
| 更新时间 | 选填 | 由表格或工具自动记录时可不手工填写 |
| 备注 | 选填 | 有需要说明的限制或待确认事项时填写 |
字段暂时没有内容时，用统一占位写法代替空白，避免“空着”和“没填”混淆。常用写法包括：“无”表示确认不适用；“待补充”表示已知缺失、需后续补齐；“通用”用于不绑定具体需求的用例。占位写法应在团队内约定一致，并定期清理“待补充”项。
填写示例：一条完整用例目录记录
下面是一条按上述模板填写的完整记录，字段顺序与空白模板一致。示例为演示情景，团队可按实际产品替换模块、需求和人员信息。
| 字段 | 填写内容 |
|---|---|
| 用例编号 | TC-LOGIN-001 |
| 用例标题 | 手机号加验证码登录成功 |
| 所属模块 | 账号与登录 |
| 目录路径 | 账号与登录/登录方式/验证码登录 |
| 关联需求 | REQ-2024-118 登录方式扩展 |
| 前置条件 | 已注册手机号 138****0000，短信验证码服务可用 |
| 操作步骤 | 1. 打开App登录页；2. 选择验证码登录；3. 输入手机号；4. 点击获取验证码并输入；5. 点击登录 |
| 预期结果 | 登录成功并跳转首页，右上角显示脱敏手机号；再次进入登录页时保持登录状态 |
| 优先级 | P1 |
| 用例类型 | 功能测试 |
| 复用范围 | 主站App 3.x 全版本回归、H5登录页回归 |
| 关联用例 | TC-LOGIN-002（密码登录）、TC-LOGIN-005（验证码错误提示） |
| 用例版本 | V1.2 |
| 变更记录 | V1.1 2024-05-20 初版；V1.2 2024-06-12 补充保持登录状态校验 |
| 负责人 | 张敏 |
| 评审状态 | 已评审 |
| 更新时间 | 2024-06-12 |
| 备注 | 依赖短信通道测试环境，验证码有效期5分钟 |
这条记录中，编号采用“模块缩写＋序号”的规则，便于按模块检索；目录路径写到第三级，与所属模块保持一致；关联需求让用例可以回溯到需求覆盖情况；复用范围写明了可复用的项目和版本，其他测试计划引用时不必重新判断适用范围；变更记录按版本逐条追加，保留修改日期和修改内容，方便评审时对比。优先级P1和评审状态“已评审”共同说明该用例属于核心回归范围且内容已确认。
目录的调整与维护方法
用例库目录建立后，字段和层级会随产品迭代、团队分工和复用需求变化。维护的目标是让目录持续可检索、可追溯，避免同一用例重复登记或版本混乱。以下操作清单可作为日常维护的检查依据。
字段增删的调整原则
- 新增字段前先确认现有字段无法表达该信息，避免同义字段并存，例如已有“用例类型”时不再新增“测试分类”。
- 新增字段先设为选填试运行一个迭代，确认填写率和实际用途后再决定是否转为必填。
- 删除字段前导出历史数据存档，并检查是否有筛选、统计或关联依赖该字段。
- 字段改名时同步更新填写说明和模板，保留旧列名与新列名的对照记录。
目录层级与命名维护
- 目录树以产品模块为骨架，层级建议控制在三到四级，过深会增加查找成本。
- 模块拆分或合并时，同步迁移用例的所属模块和目录路径，避免路径与实际结构脱节。
- 用例编号规则保持稳定，模块调整时只改目录路径，不改已发布的编号。
- 标题统一采用“验证对象＋验证点”的写法，避免“测试登录”这类无法区分场景的命名。
版本与变更记录维护
- 用例内容发生实质修改时递增版本号，并在变更记录中写明修改内容和日期。
- 进入基线或正式评审的用例锁定版本，后续修改通过新版本记录，保留可回溯的历史。
- 关联需求和关联用例在需求变更时同步检查，失效关联及时标注或解除。
- 复用范围随项目版本更新，已停止维护的版本从复用范围中移除。
定期评审与清理节奏
- 每个版本周期结束时，由负责人检查自己名下用例的更新时间，超过两个版本未更新的用例标记为“待确认”。
- 每季度做一次目录评审，重点清理重复用例、失效需求和长期“待补充”的占位字段。
- 评审结果回写到评审状态和变更记录，形成可查的维护轨迹。
- 清理前先导出备份，删除操作保留操作人和日期记录。
当团队把目录迁移到测试管理工具时，模块树、自定义属性和用例关联可以承接上述字段。ONES测试管理支持编写测试用例并组织用例库，用例模块采用树状结构、可拖拽排序，支持自定义用例属性，也支持用例与产品需求、研发任务关联；用例库中的属性支持筛选，便于按模块、优先级或负责人快速定位记录。目录中的版本号、评审状态和变更记录，可以按团队约定写入自定义属性或备注字段，具体校验规则和评审流程以团队实际配置为准。需要批量建库时，可先从Excel导入用例再在线维护，并定期导出备份。
常见问题
团队规模较小、用例数量不多时，这套18列模板需要全部保留吗？
可以按需精简。用例数量在几百条以内、由同一人维护时，建议先保留必填的七列（编号、标题、所属模块、操作步骤、预期结果、优先级、负责人），再按实际需要补充关联需求和备注。复用范围、关联用例、变更记录等列在出现跨项目复用或多版本并行时再加入。精简后应保持列名与填写说明一致，后续扩展时按S5的字段增删原则先设为选填试运行。
用例已经在需求管理工具里关联了需求，目录中还要单独记录关联需求吗？
取决于目录与需求工具的衔接方式。如果目录本身在测试管理工具中，且用例已与需求建立关联，关联需求字段可以由工具关联关系承载，目录中可只保留需求编号便于导出表格时追溯。如果目录以Excel独立维护，或需要离线评审、对外交付，建议保留该列并填写需求编号。两种方式都应以能回答“这条用例覆盖了哪个需求”为准，避免同一信息在两处维护却不一致。
用例修改后版本号怎么递增，什么情况下需要保留旧版本？
常见做法是内容发生实质修改时递增版本号：调整步骤、预期结果或前置条件属于实质修改，修正错别字、补充备注可不升版本。进入正式评审或基线的用例建议锁定当前版本，后续修改以新版本记录，旧版本保留可查，便于评审对比和问题回溯。变更记录中写明版本号、日期和修改内容，与版本号一一对应。团队应在目录建立初期就约定递增规则，避免不同负责人各自编号。
目录里的“待补充”占位项越来越多，怎么处理？
先区分两类情况：一类是信息确实缺失、需要向需求方或开发确认的，应指定确认人和期限，到期未补齐的用例在评审时单独列出；另一类是字段本身对该用例不适用，应改为“无”而不是长期挂“待补充”。建议在季度目录评审时统计“待补充”数量，按负责人分组跟进，并在变更记录中留下处理结果。占位写法统一后，筛选和统计才不会把“没填”和“不适用”混在一起。
把Excel目录迁移到测试管理工具时，哪些字段需要重新设计？
迁移时重点处理三类字段。所属模块和目录路径通常对应工具中的树状目录结构，需要先规划模块树再导入，避免路径与结构脱节。操作步骤和预期结果在表格中是长文本，导入后要确认换行和编号是否保留。版本号、评审状态、变更记录这类字段，如果工具没有对应的内置机制，可写入自定义属性或备注字段，具体校验规则以团队配置为准。ONES测试管理支持从Excel批量导入用例、自定义用例属性，并支持用例与需求关联，可作为迁移后的承载方式。
