测试用例库导入：目录映射、重复用例与版本覆盖的处理

把历史用例迁入用例库，文件能上传只是开始。真正决定导入质量的是三件事：目录能否正确对应、重复用例是否被识别、版本覆盖是否有边界。测试用例库导入的多数返工，都出在这三处没有提前对齐。 本文讨论通用方法；不同测试管理工具的菜单和字段名称不同，执行前先核对当前版本的导入模板和说明。

一、先确定用例库导入目标与边界

1. 组织级用例库和项目用例不是一回事

组织级用例库用于跨项目复用，项目用例服务于具体项目的测试任务；版本关系通常由测试计划或测试任务建立。两者入口不同，目录、去重和版本策略也不同。把项目用例导进组织库，或把组织库用例导进项目，后续处理方式并不一样。

2. 先定维护责任和导入范围

导入前要确定这批用例以后由谁维护、在哪个库维护、是否需要评审。如果同一批用例在两个地方都能改，后续很难判断哪一份是最新版本。 建议只保留一个主维护入口，另一侧按复用或归档处理。

二、目录映射：先建目录，再做映射

先看一个典型场景。

1. 目录需要先在系统里存在

不要假设导入文件会自动创建目录。常见做法是先在目标系统建好一级目录和子目录，再导出导入模板。目录（有些工具称为模块）通常按名称、路径或编号匹配；先确认目标系统用哪一种，只写显示名称可能无法识别。

目录改名或移动后，旧模板里的名称可能和当前界面对不上。编号通常仍能定位，但重新导出模板更稳妥。

2. 用编号或路径建立映射表

下面是一张最小可用的目录映射表，表中编号仅为示例。

先确认目标系统按名称、路径还是编号匹配；如果按编号或路径匹配，映射表就要记录对应的编号或完整路径。匹配依据不同，映射表的写法也不同。

3. 处理无法映射的目录

无法映射时，不要临时改导入文件里的路径。先决定是新建目录、归并到父目录，还是暂缓导入。规则定好后再改文件，否则同一批数据会出现多种目录写法，后续更难清理。

把目录、数据和版本三件事放在一张图里，关系会更清楚。

三、重复用例：先定义重复，再决定跳过还是更新

1. 系统通常不会按标题自动去重

很多测试管理工具的模板导入默认按新增处理；是否支持按编号更新，要看具体工具和导入入口。同一份文件重复导入，可能出现两批相似用例。 不要假设系统会按标题自动合并。

2. 用三个字段做导入前比对

建议在导入前做一次外部比对：目录编号、统一格式后的标题、步骤与预期的文本组合。标题先去空格、统一全半角、去掉临时版本后缀；步骤与预期把每一步的文本拼起来，作为比对值。这套方法用于导入前核对，不是系统内置的去重规则。

3. 分成新增、更新、跳过三张清单

把待导入数据和现有基线比对后，分成三张清单。

去重不是把标题相同的行删掉，而是先判断它是不是同一目录下、同一步骤集合的同一条用例。只按标题去重，容易误删不同场景。

图中标注的步骤指纹，就是正文所说的步骤与预期文本组合值。

四、版本覆盖：新增、更新与回退

1. 先判断导入模式

不同工具的导入模式不同：有的模板导入默认新增，有的会提供新增、更新或覆盖选项。先确认本次是新增还是更新，再选文件。 以禅道为例，使用系统模板导入通常按新增处理，保留用例编号的导出数据才可能定位到原记录；其他工具的名称和入口可能不同，执行前以当前版本为准。

图中的更新路径以工具支持按编号更新为前提，具体以当前版本为准。

2. 覆盖前确认影响范围

覆盖会改写现有记录。如果工具支持用例版本记录，修改后通常能查看历史；测试执行记录是否同步新版本，要看工具的确认机制。覆盖导入不应替代用例评审。 覆盖前至少确认三件事：哪些用例会被改、哪些测试任务还在引用旧版本、出错后用什么恢复。

3. 设计可回退的覆盖流程

建议按这个顺序做：导出目标用例作为基线，只改需要更新的列，保留原编号，小批量导入，在用例详情核对版本和历史，再确认测试任务是否需要同步。新增和更新分文件、分批导入，出错时更容易定位。

如果覆盖错误，先确认工具支持按编号更新，再按基线文件重新导入对应编号；如果不支持按编号回写，由管理员按导入前的整份备份恢复。覆盖前没有可用备份，不建议执行覆盖。

五、从试跑到全量的用例库导入流程

把前面的判断落成顺序，可以按六步执行。

1. 确认目标与权限：先确定组织库还是项目用例，账号需要具备导入权限。
2. 建目录并导出模板：目标目录全部存在，保留系统模板和当前用例基线。
3. 完成映射和清洗：核对目录编号、标题、类型、步骤与预期，必填字段不留空。
4. 试导一小批：如果工具提供预览，先在预览中核对目录、标题和字段；如果没有预览，导入后立即抽查，确认没有整行被忽略。
5. 分批全量：新增与更新分开，每批记录文件名、条数、操作人。
6. 复核留档：总量对得上，重复清单闭环，基线备份保留。

第4步不要省。 试导能提前暴露目录匹配、编码、必填字段和步骤格式问题，代价远低于全量重来。

六、导入后的验证与回退

导入完成后，至少核对五项：数量、目录、字段、步骤、重复与版本。数量看导入条数和成功、失败条数是否对得上；目录随机抽检一部分用例；字段检查类型、优先级、适用阶段和前置条件；步骤检查步骤与预期是否逐行对应；涉及更新的用例，再核对版本记录和测试任务关联。

回退要分情况：新增错误可以先按导入时间、目录和标题定位这批用例，再使用工具提供的删除或恢复能力清理；覆盖错误在确认支持按编号更新后，按基线文件重新导入对应编号；如果工具不支持按编号回写，再由管理员按导入前的整份备份恢复，并先在测试环境验证恢复路径。导入中途失败时，保留失败文件，修正后换新批次号重导，不要在原文件上反复改字段重试。

七、常见问题

1. 导入后能否调整用例所属目录？

单条用例通常可以编辑所属目录；批量调整入口因工具而异。调整前确认目标目录已存在，并评估对测试任务和统计的影响。

2. 同一个目录编号能否跨项目复用？

不建议直接复用。目录编号属于目标库或项目，跨项目导入需要重新映射，直接复用容易定位失败或落到错误目录。

3. 导入文件多大需要拆分？

先看工具的单次导入上限和实际耗时，再按目录或测试范围拆分。文件较大时，先试导一小批，避免因超时或大小限制导致部分记录未处理。

4. 编号为空和编号错误有什么区别？

编号为空通常按新增处理；编号有值但写错，可能定位失败，也可能改到错误记录。导入前确认编号属于当前目标库，并在预览中核对对应标题。

5. 预览有数据，保存后却少了，是什么原因？

预览通过不代表全部记录都能保存。必填字段、目录匹配、编码或上传限制都可能在保存阶段让整行被忽略，以导入结果明细为准。

八、结语

用例库导入的稳定性，不只取决于一次能传多少条，更取决于目录、编号和覆盖策略是否提前定清楚。先把目录映射做好，再用三张清单控制重复，最后用小批量试导验证覆盖结果；这三步做扎实，后续的全量导入和回退更容易控制。

具体字段、导入入口和新增、覆盖选项以所用工具的当前版本文档为准，不要直接套用其他版本的界面说明。