测试用例库目录用一张表把用例的定位信息、归属层级、复用关系和维护责任固定下来，让团队在几百上千条用例中快速找到目标、判断能否复用。本文提供一份可直接复制到Excel或文档中的空白目录表，逐字段说明填写口径，划分必填与选填，并给出覆盖登录、支付等模块的完整填写示例和后续维护规则。
要点总览（TL;DR）
- 空白目录表包含12个字段：目录编号、目录路径、用例编号、用例标题、所属模块、用例类型、优先级、复用范围、关联需求、维护人、最近评审日期、状态，可直接复制到Excel或文档。
- 目录层级建议采用三级命名，用“/”连接，一级对应产品线或业务域，二级对应功能模块，三级对应具体场景或测试类型。
- 必填字段为目录编号、目录路径、用例编号、用例标题、所属模块、维护人、状态，其余字段可按团队成熟度逐步启用。
- 填写示例覆盖登录与支付模块，展示目录行与用例行的填法差异，以及复用范围从通用到单项目的递进。
- 维护按季度整体评审，重点清理长期未更新、待评审超期和从未被引用的通用用例，维护人变更时逐条交接。
可复制空白目录模板
下表可直接复制到Excel、在线表格或文档中使用。表头为字段名，下方留两行空行供填写。复制到Excel时，建议将第一行设为冻结窗格，并按“目录编号”升序排列，便于按层级浏览。
| 目录编号 | 目录路径 | 用例编号 | 用例标题 | 所属模块 | 用例类型 | 优先级 | 复用范围 | 关联需求 | 维护人 | 最近评审日期 | 状态 |
|---|---|---|---|---|---|---|---|---|---|---|---|
目录层级建议采用三级命名约定，层级之间用“/”分隔，写在“目录路径”字段中：
- 一级目录对应产品线或业务域，例如“用户中心”“交易支付”“订单履约”。一级目录数量控制在个位数，避免顶层过于分散。
- 二级目录对应功能模块，例如“用户中心/登录注册”“交易支付/退款”。二级目录是日常查找的主要入口。
- 三级目录对应具体场景或测试类型，例如“用户中心/登录注册/异常登录”“交易支付/退款/部分退款”。三级目录按需设置，场景简单的模块可以只到二级。
目录编号与目录路径配合使用：目录编号是稳定标识，路径调整时编号不变；目录路径是可读定位，方便人工浏览。用例编号在目录内唯一，建议采用“模块缩写-序号”的形式，例如“LOGIN-001”。
每个字段记录什么
字段说明与空白模板、填写示例保持同一口径。下表逐字段解释含义和填写方式。
| 字段 | 含义 | 填写口径 |
|---|---|---|
| 目录编号 | 目录节点的稳定标识 | 按层级编码，如“D01”“D01-02”“D01-02-03”，新增目录顺延编号，不复用已废弃编号 |
| 目录路径 | 用例在库中的层级位置 | 用“/”连接各级目录名称，与目录编号一一对应 |
| 用例编号 | 用例在目录内的唯一标识 | 模块缩写加序号，如“PAY-012”，同一目录内不重复 |
| 用例标题 | 一句话说明验证什么 | 采用“场景+预期”的写法，如“余额不足时支付失败并提示” |
| 所属模块 | 用例对应的产品功能模块 | 填写产品模块名称，如“支付”“登录”，与需求文档中的模块划分对齐 |
| 用例类型 | 用例的测试性质 | 可选功能、接口、性能、兼容性、安全等，按团队既有分类填写 |
| 优先级 | 执行与维护的优先程度 | 用高、中、低三档，高对应核心主流程，低对应边缘场景 |
| 复用范围 | 用例可被哪些项目或版本复用 | 填写“通用”“本产品线”“单项目”等范围标签，通用用例需通过评审 |
| 关联需求 | 用例来源的需求或任务 | 填写需求编号或需求标题，便于需求变更时反查受影响用例 |
| 维护人 | 对该目录或用例负责的人 | 填写具体姓名，目录级维护人对整条路径负责 |
| 最近评审日期 | 上一次评审通过的时间 | 填写日期，如“2025-03-14”，用于判断是否到期复审 |
| 状态 | 目录或用例的当前可用性 | 可选有效、待评审、已废弃、草稿，废弃项保留记录但不再执行 |
容易混淆的是“所属模块”与“目录路径”。目录路径描述用例在库中的组织位置，可以按业务域、版本或测试类型组织；所属模块描述用例对应的产品功能，与需求管理中的模块划分一致。同一条用例的目录路径可能因组织方式调整而变化，所属模块应保持稳定，便于跨目录统计模块覆盖率。
必填与选填的划分
必填字段的标准是：缺少它就无法定位用例或无法判断能否复用。下表给出划分和理由。
| 字段 | 填写要求 | 理由或适用场景 |
|---|---|---|
| 目录编号 | 必填 | 目录的唯一标识，缺失后无法稳定引用和迁移 |
| 目录路径 | 必填 | 人工查找的主要入口，缺失后用例无法被定位 |
| 用例编号 | 必填 | 用例的唯一标识，执行记录和缺陷关联都依赖它 |
| 用例标题 | 必填 | 快速判断用例内容，缺失后只能逐条打开查看 |
| 所属模块 | 必填 | 统计模块覆盖率和关联需求的依据 |
| 维护人 | 必填 | 明确责任归属，避免用例长期无人更新 |
| 状态 | 必填 | 区分可用与废弃，防止执行过期用例 |
| 用例类型 | 选填 | 团队按测试类型分工时填写，初期可统一留空 |
| 优先级 | 选填 | 用例量较大、需要安排执行顺序时填写 |
| 复用范围 | 选填 | 存在跨项目复用需求时填写，单项目团队可暂不填 |
| 关联需求 | 选填 | 需求管理较规范、需要变更影响分析时填写 |
| 最近评审日期 | 选填 | 建立定期评审机制后填写，用于计算复审到期 |
必填字段缺失时，不应直接入库。处理方式分两种：新登记用例缺必填项，退回登记人补齐后再提交；历史用例缺必填项，标记为“待补全”并指定维护人在约定周期内补齐，补齐前不纳入复用范围。选填字段可以随团队成熟度逐步启用，例如先补优先级，再补关联需求。
一份填好的目录示例
以下示例覆盖登录、支付两个模块，包含不同目录层级和复用范围，字段与前述模板、说明一一对应。
| 目录编号 | 目录路径 | 用例编号 | 用例标题 | 所属模块 | 用例类型 | 优先级 | 复用范围 | 关联需求 | 维护人 | 最近评审日期 | 状态 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| D01 | 用户中心 | — | — | 用户中心 | — | — | 通用 | — | 张敏 | 2025-03-10 | 有效 |
| D01-02 | 用户中心/登录注册 | — | — | 登录 | — | — | 通用 | — | 张敏 | 2025-03-10 | 有效 |
| D01-02-01 | 用户中心/登录注册/正常登录 | LOGIN-001 | 账号密码正确时登录成功并跳转首页 | 登录 | 功能 | 高 | 通用 | REQ-1024 登录改造 | 张敏 | 2025-03-10 | 有效 |
| D01-02-02 | 用户中心/登录注册/异常登录 | LOGIN-008 | 连续五次密码错误后账号锁定十分钟 | 登录 | 功能 | 中 | 本产品线 | REQ-1024 登录改造 | 李哲 | 2025-02-26 | 有效 |
| D02 | 交易支付 | — | — | 支付 | — | — | 通用 | — | 王琳 | 2025-03-12 | 有效 |
| D02-01 | 交易支付/收银台支付 | PAY-003 | 余额充足时支付成功并生成订单 | 支付 | 功能 | 高 | 通用 | REQ-1108 收银台改版 | 王琳 | 2025-03-12 | 有效 |
| D02-02 | 交易支付/退款 | PAY-012 | 部分退款后订单状态与退款金额一致 | 支付 | 功能 | 高 | 本产品线 | REQ-1130 退款流程 | 王琳 | 2025-03-05 | 有效 |
| D02-02 | 交易支付/退款 | PAY-015 | 退款接口超时后自动重试并最终一致 | 支付 | 接口 | 中 | 单项目 | REQ-1130 退款流程 | 陈昊 | 2025-01-18 | 待评审 |
示例中目录行（如D01、D02）只填目录级字段，用例行填完整信息。复用范围从“通用”到“单项目”递进，通用用例经过评审后可供多条产品线引用。状态为“待评审”的用例保留在库中，但不进入复用清单，待评审通过后再改为“有效”。
目录的调整与维护方法
目录建好后，随版本迭代和模块调整持续变化。维护的目标是让复用资产保持可查、可信、可交接。以下规则可按团队规模裁剪执行。
新增目录与用例的登记流程
- 登记人先判断新用例应挂在哪条现有路径下，能复用现有目录的不新建目录。
- 确需新建目录时，由目录维护人分配目录编号，编号在父级下顺延，不复用已废弃编号。
- 用例入库前检查必填字段是否齐全，选填字段按当前启用范围填写。
- 新增或修改的用例标记为“待评审”，评审通过后改为“有效”并更新最近评审日期。
目录合并、迁移与废弃的处理规则
- 合并：两个目录职责重叠时，保留编号较小或使用更广的目录，另一目录下的用例迁移后，原目录编号标记为废弃并注明去向。
- 迁移：用例更换目录路径时，用例编号保持不变，目录路径更新，关联需求和维护人同步核对。
- 废弃：功能下线或需求取消时，目录和用例状态改为“已废弃”，保留记录供追溯，不再纳入执行和复用范围。
评审与清理的周期建议
建议按季度对目录做一次整体评审，重点检查三类问题：长期未更新且关联需求已关闭的用例、状态为“待评审”超过一个周期的用例、复用范围为“通用”但从未被引用的用例。评审后更新最近评审日期，对确认失效的用例执行废弃。核心模块的目录可以缩短到每月抽查一次。
维护责任人的交接方式
维护人离职或转岗时，由目录维护人发起交接：列出其名下所有目录和用例，指定接手人，逐条确认状态和最近评审日期，交接完成后更新维护人字段。交接记录保留在目录变更说明中，避免出现无人认领的用例。团队使用测试管理工具承载用例库时，目录字段可以落到工具的用例属性中。例如ONES TestCase支持编写用例、组织用例库，用例模块支持树状结构与拖拽排序，可自定义用例属性，并支持从Excel批量导入用例、将用例与需求和研发任务关联，目录表中的层级和字段可以据此配置，减少表格与工具两套维护的成本。
常见问题
目录编号和用例编号可以合并成一个字段吗？
不建议合并。目录编号标识的是目录节点，一条目录下可以挂多条用例；用例编号标识具体用例，执行记录、缺陷关联都依赖它。合并后目录行和用例行混在同一列，按编号排序时层级关系会丢失，迁移目录时也无法保持用例编号不变。如果表格列数紧张，可以保留两个编号字段，把目录路径作为可读定位，目录编号仅在需要稳定引用时使用。
团队用例只有一两百条，还需要建三级目录吗？
可以只建到二级。三级目录的价值在于把场景复杂的模块进一步细分，用例量不大时二级目录已经能快速定位。判断标准是：在二级目录下浏览时，是否能在一屏内找到目标用例。如果某个模块的用例超过几十条、场景差异明显，再为它增设三级目录。层级约定可以预留，不必一次建满。
历史用例缺必填字段，是补全还是直接废弃？
先判断用例是否仍在执行。仍在执行的用例标记为“待补全”，指定维护人在约定周期内补齐必填字段，补齐前不纳入复用范围；已经不再执行、关联需求也已关闭的用例，直接改为“已废弃”并保留记录。两类处理都要在目录中留下状态，避免出现既没补全也没废弃的中间态。
目录表在测试管理工具里怎么落地，还需要维护Excel吗？
可以把目录层级和字段配置到测试管理工具的用例库中，以工具作为唯一数据源，Excel只用于批量导入和导出备份。例如 ONES TestCase 支持编写用例、组织用例库，用例模块支持树状结构与拖拽排序，可自定义用例属性，并支持从 Excel 批量导入用例、将用例与需求和研发任务关联。落地时先核对工具中可配置的属性与目录表字段的对应关系，再决定哪些字段保留在表格中作为补充说明。
目录合并后，原来引用旧目录编号的文档和报告怎么处理？
合并时保留原目录编号的记录并注明去向，不直接删除。引用旧编号的测试计划、报告和缺陷记录按原编号仍可追溯，新登记的用例统一挂到保留目录下。如果团队有定期输出的覆盖率报告，在下一期报告中改用新编号，并在报告说明中标注一次变更对应关系，避免读者对不上号。
