在禅道中编写测试用例有四种标准方法:一、单个创建,适用于少量精细用例;二、批量录入,适用于结构化草稿一次性添加;三、CSV模板导入,需严格匹配字段与UTF-8编码;四、AI辅助生成后整理导入,提升覆盖率与效率。

如果您需要在禅道中为产品功能编写规范、可执行、可追溯的测试用例,但尚未掌握标准操作路径与关键字段填写逻辑,则可能是由于对用例结构、模块归属及步骤粒度理解不足。以下是完成此项任务的具体方法:
一、单个创建测试用例
该方式适用于新增少量用例或需精细控制每项字段的场景,确保用例与具体需求强关联、前置条件明确、步骤可验证。
1、登录禅道系统,点击顶部导航栏的【测试】模块。
2、在左侧菜单中选择【用例】→【功能测试】(若为接口测试则选【接口测试】)。
3、点击页面右上角的【建用例】按钮。
4、在新建页面中,依次填写:所属产品、所属模块、用例标题、用例类型、适用阶段(支持多选)、相关研发需求(必选以实现需求追溯)。
5、在【前置条件】栏填写执行前提,例如“用户已登录且权限为管理员”。
6、在【步骤】表格中逐行填写操作动作;每步右侧对应【预期结果】列,须为可验证的明确表述,如“页面跳转至订单列表,显示最新3条未支付订单”。
7、点击【+】可追加步骤行;使用√和×可对步骤进行分组(如主流程/异常分支)。
8、确认无误后,点击底部【保存】按钮,该用例即进入用例库并生成唯一编号。
二、批量录入创建测试用例
该方式适用于已有结构化用例草稿(如Excel整理表),需一次性导入多个用例,提升效率并保持字段一致性。
1、在【用例】→【功能测试】页面,点击【批量创建】→【多项录入】。
2、在弹出窗口中,按顺序填写产品、模块、标题、步骤、预期结果、关键词等字段;每条用例占一行,步骤与预期结果之间用换行符分隔。
3、支持连续添加多条用例,每条用例的适用阶段、用例类型、前置条件可单独设置或统一默认。
4、全部填写完毕后,点击【确定】,系统将校验格式并一次性创建所有用例。
三、CSV模板导入测试用例
该方式适用于从外部文档(如Excel、Notion导出)迁移大量历史用例,要求数据格式严格匹配禅道模板结构,避免字段错位或编码异常。
1、在【用例】→【功能测试】页面,点击【导入】→【导出模板】,下载标准CSV模板文件。
2、用Excel打开模板,在对应列中逐条填写:product(产品ID或名称)、module(模块ID或路径)、title(标题)、precondition(前置条件)、steps(步骤,多步用换行符分隔)、expect(预期结果,与steps一一对应)、type(用例类型代码,如"feature")、stage(适用阶段,英文逗号分隔,如"system,smoke")。
3、确保CSV文件编码为UTF-8无BOM格式,否则中文字段将显示乱码。
4、返回禅道导入页面,点击【导入CSV】,选择已编辑完成的文件,勾选【自动匹配字段】,点击【开始导入】。
5、系统显示成功导入数量及失败原因(如字段为空、模块不存在),根据提示修正后可重新上传。
四、借助AI辅助生成测试用例再导入
该方式适用于需求文档详实但人工编写耗时长的场景,利用大模型快速产出覆盖正向、边界、异常的用例初稿,再经人工校验后结构化填入禅道。
1、准备输入材料:提供清晰的需求描述、接口文档片段、原型图链接或自然语言功能说明。
2、向AI工具(如DeepSeek、文心一言)发送Prompt,示例:“请为‘用户修改手机号’功能生成5条测试用例,包含正常修改、原手机号错误、新手机号已注册、验证码超时、网络中断五种场景;输出为表格,列名:用例编号、场景描述、前置条件、测试步骤、预期结果。”
3、将AI返回结果整理为CSV格式,严格对照禅道模板字段映射(如将“测试步骤”填入steps列,“预期结果”填入expect列)。
4、按第三种方法中的CSV导入流程,完成批量导入。










