禅道测试用例怎么导入Excel：从模板准备到批量校验

把几百条测试用例从 Excel 搬进禅道，常见的出错点不是点击导入，而是导入前的格式判断。禅道测试用例怎么导入 Excel，并没有一个固定入口：部分版本走 CSV 模板，企业版或专业版支持 xlsx、xls；模板文件通常新增记录，带用例编号的数据文件则可能修改已有用例。先分清这两件事，后面的模板、字段和校验才有意义。

先分清：Excel 文件不等于 Excel 导入

按禅道官方的用例导入说明，测试用例页提供“导入CSV”，需要先通过“导出—导出模板”拿到 Template.csv；Excel 导入导出则支持 xlsx 或 xls，同样从“导出模板”开始。两者的共同点是模板必须由系统生成，差别在文件格式和入口。

下面这张表用于快速判断该走哪条路径。

能导出 xlsx 不代表可以任意上传自制表格，导入文件仍要以系统导出的模板或数据文件为基础。不要把 .xlsx 直接改后缀成 .csv，字段和编码都可能出错；也不要删表头、合并单元格或在数据区插入空行。先确认入口和文件格式，再处理字段映射。

图1：先确认文件格式与导入入口，再处理字段映射。

导入前准备：模块、需求和权限先到位

模板里的“所属模块”和“相关需求”不是随便写名称。官方字段说明要求这两类系统数据带 (#ID)，例如模块写成“登录模块(#142)”，系统才能识别到具体记录。模块本身不能靠导入创建，需要先在禅道里建好，再导出模板；导出前建好模块，模板里才能选到它。

相关需求同理。需求尚未建立时，先留空或补建后再导，不要手填一个不存在的编号。账号方面，确认具备测试用例的查看、创建和导入权限；权限不确定时，用有权限的账号先做小样本试导，比全量失败后再排查更省事。

还要确定落点：是导入某个产品的用例列表，还是先进入用例库做公共资产。前者适合当前版本的直接执行，后者适合跨产品复用。路径不同，模板里的产品、模块和需求范围也不同。

获取并填写模板：字段逐项对齐

从“测试—用例—导出—导出模板”进入，选择需要的记录范围和文件格式，保存后得到模板。不要从空白工作簿开始搭表，模板的列名、顺序和下拉值就是导入时的映射依据。

官方字段说明列出了可导入的用例字段，下面按填写顺序拆开。

表格里常被低估的是步骤和预期。官方规则是每步换行，序号在前，用英文句点与内容分隔；没有对应步骤的预期无效，某一步没有预期时该行留空。把一段操作说明整段粘进一个单元格，导入后通常只剩一条步骤，后续执行也无法逐条记录结果。

填写时再守住三条：必填的“用例标题”“用例类型”不能空；编号和日期用文本格式；模板外的批注、颜色、合并单元格不要带进导入文件。

图2：导入前按 6 项清单检查字段，能减少大部分返工。

执行导入：先小样本，再全量

进入“测试—用例—导入”，选择文件。若页面提供编码选项，选择与文件实际编码一致的一项；不确定时先用 UTF-8 保存一份小样本试导，出现乱码再调整，不要在全量文件上反复试。

上传后系统会显示待导入的数据明细。这一步要慢一点：核对列名是否自动匹配、模块和需求是否识别到 ID、步骤与预期是否分列。确认无误再点保存。

这里有一个影响很大的分支：使用模板文件导入，记录通常按新增处理；使用非模板的数据文件且“用例编号”有值时，系统可能把该行当作对已有用例的修改。 如果只是想追加用例，导入前把用例编号列清空；如果要批量修改，先导出当前数据做备份，再小范围验证修改结果。

首次导入建议只放 10 条，覆盖一个模块、一个需求和三种优先级。导入成功后回到用例列表，确认数量、模块和详情都正确，再替换为全量文件。

图3：小样本导入后，团队一起核对数量、模块和步骤映射。

批量校验：导入后先查五件事

导入成功提示不等于数据可用。批量导入后按下面五项核对，顺序从整体到明细。

1. 数量：用源文件的有效行数对比导入条数。空行、缺必填字段的行会被忽略，差额要能逐条解释。
2. 模块：随机打开几条用例，确认落在目标模块，而不是根节点。模块错了，后续按模块筛选和关联测试单都会受影响。
3. 步骤与预期：抽查第一条、最后一条和中间三条，确认步骤条数与预期条数一致，序号没有错位。
4. 需求关联：查看用例详情里的相关需求是否为空。为空时，要么在系统里批量补充，要么带 (#ID) 重新导入。
5. 重复与覆盖：按标题搜索是否出现重复用例；如果导入前做过备份，再对比旧数据，确认没有旧用例被意外修改。

抽样不要只看导入成功的那几条。把导入明细里提示失败或忽略的行全部查一遍，再随机抽取约 10% 的成功记录，覆盖边界值和步骤较多的用例。数量和模块决定这批数据能不能用，步骤、需求和覆盖决定后续执行会不会出错。

图4：导入后用 5 项核对把“导入成功”变成“可以执行”。

常见错误与回退：按症状定位

多数导入问题能在模板里找到原因。下面按症状列出处理方向。

发现导错后先停手，不要再导入一版“覆盖修正”。禅道的删除通常是标记删除，可以在后台的系统数据里找到回收站并还原；但被修改的旧用例不一定能靠回收站回到原样，所以修改型导入前必须导出备份。误导入的新记录可以筛选出来移入回收站，确认无误后再决定是否彻底删除。

图5：按症状、原因、处理三步定位导入问题。

导入之后：把用例接入测试执行

用例进入系统只是完成资产迁移。接下来在测试单中关联这批用例，按模块或需求筛选，指派给执行人，记录通过、失败、阻塞等结果；执行失败时再转 Bug，形成从用例到问题的闭环。常用用例还可以沉淀到用例库，后续按产品引用，避免每个版本重复导入。

回到最初的问题，禅道测试用例怎么导入 Excel，关键不在最后一次点击，而在前面三件事：确认当前版本支持的文件格式，用系统模板把字段和 (#ID) 对齐，导入后按数量和明细做批量校验。把这三点固定成流程，几百条用例的迁移就不再依赖某个人记住所有细节。

参考资料：禅道官方手册《撰写用例》（2025-09-04 更新）、《导入excel、csv参考文档》、《Excel 导入导出（企业版）》、《恢复删除的资源》、《提交测试单》。