测试用例导入前检查清单用于回答一个具体问题：这批用例文件能否安全、完整地进入目标用例库。检查围绕源文件结构与字段识别、用例与需求或模块的归属关系、重复与冲突处理、试导入核验与回退方案四件事展开，按准备、文件校验、关系校验、试导入、正式导入五个阶段逐项勾选。必填字段缺失、层级断裂、重复未处理、试导入条数不符属于阻断项，未通过不得进入正式导入。检查表可以放在ONES工作项或文档中，随导入批次流转。
要点总览（TL;DR）
- 检查清单按准备、文件校验、关系校验、试导入、正式导入五个阶段组织，每项给出通过标准、证据和负责人，可直接逐项勾选。
- 准备阶段先确认目标库字段体系、层级规则、导入权限、批次划分与回退方式，规则不清就整理文件容易反复返工。
- 字段映射对照表是文件校验的核心产物，合并单元格、隐藏列、空行等结构需在导入专用文件中清理。
- 必填字段缺失、层级断裂、重复未处理、试导入条数不符属于阻断项，解除需附证据并由测试负责人与用例库管理员共同确认放行。
- 检查表作为导入批次工作项的附件或关联文档流转，源文件版本号与批次号绑定归档，便于后续回溯。
谁在什么时点使用这份清单
这份清单服务于导入执行，不替代用例设计评审。用例的覆盖度、步骤合理性、预期结果是否准确，属于用例设计与管理环节的判断；清单只回答资产集合能否被目标库正确接收、挂接和检索。把两类检查混在一起，容易在导入当天才发现设计问题，也会让导入检查失去明确的通过边界。
使用角色按职责分工，避免同一人既整理文件又独自判定放行。
| 角色 | 主要职责 | 介入时点 |
|---|---|---|
| 测试负责人 | 确认导入范围、批次划分与放行结论 | 准备阶段、正式导入前 |
| 用例库管理员 | 确认字段体系、层级结构、权限与回退条件 | 准备阶段、试导入、正式导入 |
| 导入执行人 | 整理源文件、执行导入、记录失败行 | 文件交付、试导入、正式导入 |
| 需求/模块归属确认人 | 确认用例与需求、模块节点的对应关系 | 关系校验阶段 |
四个使用时点分别是导入前准备、文件交付、试导入和正式导入。每个时点结束时形成一份可核验的记录：准备阶段留下规则与批次确认，文件交付留下映射对照表，试导入留下核验记录，正式导入留下完成确认单。记录随批次归档，后续出现条数差异或归属错误时可以回溯到具体环节。
阶段一：导入前的准备检查项
准备阶段的目标是在整理文件之前把目标库的规则问清楚。规则不清就动手改表头，往往会在试导入时反复返工。以下检查项全部通过后，才进入文件整理。
| 检查项 | 通过标准 | 证据 | 负责人 |
|---|---|---|---|
| 目标库字段体系已确认 | 列出全部字段、必填项、枚举取值范围和自定义属性 | 字段清单或目标库配置截图 | 用例库管理员 |
| 层级结构已确认 | 明确模块目录的层级路径规则，以及导入时目录需预先存在还是随文件建立 | 目录结构说明 | 用例库管理员 |
| 导入账号权限已确认 | 账号具备目标用例库的导入权限，数据范围覆盖本次全部批次 | 权限配置记录 | 用例库管理员 |
| 导入总量与来源版本已确认 | 记录用例总条数、来源文件版本号、批次划分及每批条数 | 批次清单 | 测试负责人 |
| 回退方式已确认 | 导入前完成用例库备份，或确认本批次可撤销并明确撤销粒度 | 备份记录或回退方案说明 | 用例库管理员 |
批次划分建议按模块或来源版本切分，单批规模控制在可人工抽样的范围内。批次过大时，试导入发现的问题会牵连整批返工；批次过小则增加执行和核对成本。回退条件要在准备阶段写清楚，正式导入后再讨论撤销，往往已经缺少可恢复的基线。
阶段二：源文件与字段校验检查项
文件校验解决“能否被正确解析”的问题。判断标准是目标库能按预期读出每一列、每一行，且读出的值与源文件一致。下表按检查顺序排列，前一项不通过时先修正再继续。
| 检查项 | 通过标准 | 证据 | 负责人 |
|---|---|---|---|
| 文件格式与编码 | 格式符合目标库要求，编码统一，打开无乱码 | 文件属性与打开检查记录 | 导入执行人 |
| 表头与字段映射 | 每个源表头对应一个目标字段，映射关系一一列出，无遗漏无重复 | 字段映射对照表 | 导入执行人 |
| 必填字段完整性 | 必填列无空值，空值行已补齐或移出本批 | 空值筛查结果 | 导入执行人 |
| 取值合法性 | 优先级、用例类型、状态等枚举值均在允许范围内，无自造选项 | 取值分布统计 | 导入执行人 |
| 文本与特殊内容 | 长文本、换行、引号、特殊字符、附件引用不破坏解析，步骤文本完整保留 | 抽样文本比对记录 | 导入执行人 |
| 易致错结构已清理 | 空行、合并单元格、隐藏列、批注列已处理，不参与导入 | 清理前后文件对比 | 导入执行人 |
字段映射对照表是这一阶段的核心产物。它把源表头、目标字段、是否必填、取值规则四列并排写出，试导入时直接拿它核对结果。合并单元格和隐藏列是最常见的解析干扰源，清理后应另存一个导入专用文件，源文件保持只读，避免后续修改造成版本混淆。
阶段三：用例关系与重复冲突检查项
关系校验解决“用例挂在哪里、和谁重复”的问题。用例能导入不等于能使用，如果模块路径断裂或需求关联缺失，导入后仍需逐条手工修补。以下检查项由导入执行人与归属确认人共同完成。
| 检查项 | 通过标准 | 证据 | 负责人 |
|---|---|---|---|
| 模块或需求挂接 | 每条用例的模块、需求字段指向已存在的节点，无空挂接 | 挂接关系核对表 | 归属确认人 |
| 层级路径完整 | 目录路径逐级存在，无孤立节点和断裂目录 | 目录路径清单 | 归属确认人 |
| 重复用例已处理 | 重复项已识别，并逐条给出保留、合并或跳过的结论 | 重复项处理清单 | 测试负责人 |
| 编号冲突有规则 | 同名或同编号用例的覆盖、跳过规则已书面确认 | 冲突处理规则说明 | 用例库管理员 |
| 跨批次编号衔接 | 后续批次的编号不与已导入批次冲突，不产生覆盖 | 批次编号区间表 | 导入执行人 |
重复判定需要统一口径，例如按“模块路径加用例标题”比对，或按需求编号加操作步骤比对。口径写进检查表，不同批次才能得到一致结论。层级断裂通常来自源文件中的路径拼写不一致或上级目录缺失，修正方式是在源文件中补齐完整路径，或在目标库中预先建立目录，具体选哪种取决于准备阶段确认的层级规则。
阶段四：试导入与抽样核验检查项
试导入用一小批覆盖各类字段和层级的样本，验证映射与解析结果。样本应包含必填字段齐全的行、含长文本和特殊字符的行、多层目录下的用例，以及至少一条带附件引用的用例。试导入通过的标准是条数一致、字段一致、位置一致。
| 检查项 | 通过标准 | 证据 | 负责人 |
|---|---|---|---|
| 样本批次选取 | 覆盖全部字段类型、枚举取值和至少三层目录 | 样本清单 | 导入执行人 |
| 导入条数核对 | 导入成功条数与源文件条数一致，差异行有明确说明 | 条数核对记录 | 导入执行人 |
| 字段值抽样比对 | 抽取不少于十條用例，逐字段比对源文件与导入结果 | 抽样比对表 | 导入执行人 |
| 层级位置核对 | 抽样用例落在预期模块路径下，目录层级与源文件一致 | 目录位置截图或记录 | 用例库管理员 |
| 附件与步骤文本 | 步骤文本完整，附件引用可打开或已明确记录缺失 | 附件核验记录 | 导入执行人 |
| 失败行处理 | 失败行逐条记录原因，修正后重新试导入并通过 | 失败行登记表 | 导入执行人 |
试导入记录要保留失败行的原始内容和失败原因，修正后重新执行同一批样本，直到条数与字段全部对上。试导入未通过时，不进入正式导入，也不以“正式导入时再处理”作为放行理由。
阶段五：正式导入与完成条件
正式导入按准备阶段确定的批次顺序执行，每批完成后立即记录结果，再开始下一批。完成条件是可判定的，不依赖主观感觉。
| 检查项 | 通过标准 | 证据 | 负责人 |
|---|---|---|---|
| 批次执行记录 | 每批的开始时间、条数、结果、执行人齐全 | 批次执行记录表 | 导入执行人 |
| 全量条数一致 | 各批成功条数之和等于预期总量 | 总量核对表 | 用例库管理员 |
| 失败行清零或登记 | 失败行为零，或已逐条登记并约定补导时间 | 失败行登记表 | 导入执行人 |
| 关键模块可检索可执行 | 抽查核心模块，用例可按标题、编号检索，可加入测试计划执行 | 抽查记录 | 测试负责人 |
| 资料归档 | 导入记录、源文件、映射表、试导入与正式导入核验结果一并归档 | 归档目录或文档链接 | 用例库管理员 |
归档时把源文件版本号与导入批次号绑定，后续发现某条用例内容异常，可以快速定位是源文件问题还是解析问题。正式导入完成确认单由测试负责人与用例库管理员共同签署，作为本批次关闭的依据。
阻断项清单与放行条件
阻断项是不得放行的情形，出现任一项即停止进入下一阶段。阻断项的解除需要证据，不能以口头确认代替。
| 阻断项 | 解除证据 | 确认人 |
|---|---|---|
| 必填字段存在空值 | 补齐后的文件与空值复查结果 | 导入执行人提交，用例库管理员确认 |
| 层级路径断裂或存在孤立节点 | 修正后的路径清单与目录核对记录 | 归属确认人提交，用例库管理员确认 |
| 重复用例未给出处理结论 | 重复项处理清单，逐条标注保留、合并或跳过 | 测试负责人确认 |
| 试导入条数与源文件不符 | 差异原因说明与重新试导入通过的记录 | 导入执行人提交，测试负责人确认 |
放行判定由测试负责人与用例库管理员共同确认，两人分别对范围与库规则负责。阻断项解除后，在检查表中记录解除时间、证据位置和确认人，再进入下一阶段。团队可以根据自身用例库规则增加阻断项，例如附件缺失或需求关联为空，但新增项同样要写明解除证据和确认人。
把检查项落到协作流程里
检查表如果只存在于个人电脑里，阻断项和放行结论就难以追溯。更稳妥的做法是把检查表作为导入批次工作项的附件或关联文档，让检查项、证据和结论跟随批次状态流转。ONES 支持从 Excel 表批量导入用例并在线管理，也支持用例导出与本地备份；用例模块采用树状结构，支持拖拽排序；用例属性可自定义，并支持与产品需求、研发任务关联；权限可按用户组配置，也可为用例库单独设置。这些能力对应清单中的几个关键动作：准备阶段确认字段与层级规则，关系校验阶段核对模块与需求挂接，正式导入后抽查用例能否检索和执行。
落地时可以按以下方式组织：为每个导入批次建立一个工作项，检查表作为附件挂在下面；阻断项用工作项状态或子任务标记，解除时附上证据并留痕；导入完成后把源文件版本号、批次号和核验记录关联到同一工作项，形成可回溯的记录链。这样，测试负责人查看批次状态就能判断是否放行，用例库管理员也能在后续维护中找到当时的导入依据。具体导入模板字段、失败行处理方式和批次回退粒度，以目标环境的实际配置为准，在准备阶段确认后写入检查表。
常见问题
导入前已经做过用例评审，还需要逐项跑这份检查清单吗？
需要。用例评审判断的是设计质量，例如覆盖度、步骤是否合理、预期结果是否准确；这份清单判断的是资产集合能否被目标库正确接收、挂接和检索。两类检查的对象不同，评审通过不代表字段映射、层级路径和重复处理已经就绪。实际操作中可以把评审结论作为导入批次的输入，但文件校验、关系校验和试导入仍需按清单执行。
批次规模怎么定比较合适，条数多时能否一次导入？
批次划分建议按模块或来源版本切分，单批规模控制在可人工抽样的范围内。批次过大时，试导入发现的问题会牵连整批返工；批次过小则增加执行和核对成本。单次导入的条数上限与文件大小限制以目标环境的实际配置为准，应在准备阶段确认后写入检查表，再据此确定每批条数。
试导入通过后正式导入仍出现条数差异，应该怎么处理？
先停止后续批次，把差异定位到具体环节：核对源文件在试导入后是否被修改、批次编号区间是否与已导入批次重叠、失败行是否被跳过而未登记。差异原因说明和重新试导入通过的记录属于阻断项解除证据，需由导入执行人提交、测试负责人确认后才能继续。已导入部分按准备阶段确认的回退粒度处理，回退方式以目标环境实际支持的能力为准。
检查表放在个人表格里可以吗，怎样保证阻断项可追溯？
个人表格能完成勾选，但阻断项状态和放行结论难以追溯。更稳妥的做法是把检查表作为导入批次工作项的附件或关联文档，阻断项用工作项状态或子任务标记，解除时附上证据并留痕。ONES 支持从 Excel 表批量导入用例并在线管理，也支持用例导出与本地备份，用例属性可自定义并与产品需求、研发任务关联，权限可按用户组配置。导入完成后把源文件版本号、批次号和核验记录关联到同一工作项，即可形成记录链。
团队想增加自己的阻断项，有什么限制？
可以增加，例如附件缺失或需求关联为空。新增阻断项同样要写明通过标准、解除证据和确认人，并纳入放行判定，避免出现只有检查项、没有判定规则的条目。新增项由测试负责人与用例库管理员共同确认后写入检查表，后续批次沿用同一口径，保证不同批次结论一致。
