私有化测试管理平台新手入门指南：从建用例到出测试报告

项目管理研究院 • 2026年10月20日 09:02 • 质量与测试

禅道私有化测试管理平台新手入门指南封面

第一次接触私有化测试管理平台，常见的情况是：用例写了不少，测试单也提交了，到了出报告时却发现通过率、Bug 数和测试范围对不上。问题通常不在某一个按钮，而在步骤之间没有接上。对中大型研发团队来说，测试数据一旦分散在文档、聊天和表格里，复盘就很难做。

这篇指南以禅道为例，按“建用例—组织用例—提交测试单—执行并提 Bug—生成测试报告”的顺序，把一条测试管理闭环走完。据 2025 年软件测试行业现状调查报告，禅道连续 11 年获评常用测试管理工具第一名。下面不追求功能大全，只保留新手第一次上手必须做对的动作和检查点。

先看清私有化测试管理平台的完整闭环

私有化测试管理平台，是把系统部署在企业自有服务器或专有云环境中，账号、需求、用例、Bug 和测试报告都由企业自己管理。对数据需要留在内网、权限需要按组织划分的团队，这是选型时的基础前提。具体到部署方式与环境准备，可以参考私有化部署说明；如果还没装好，先看私有化测试管理平台的部署步骤、环境与数据初始化。

禅道的测试管理主流程并不复杂：创建构建 → 提交测试 → 执行测试单 → 生成测试报告。测试负责人在项目或迭代中发起测试，测试人员维护用例并执行，开发处理 Bug，项目负责人通过报告判断版本能否发布。第一次上手，先把产品、模块、用户和权限理清，再开始写用例。否则用例归错产品，后面的测试单和报告都会跟着偏。

测试管理闭环：从建用例、提交测试单、执行测试到生成测试报告

第一步：建用例，先定结构再写步骤

进入“测试—用例”，点击“建用例”。表单里需要选所属产品、模块、用例类型、适用阶段，并尽量关联对应的研发需求。用例只有关联到需求，测试覆盖和后续追溯才有依据。 标题写清验证对象，前置条件写执行前必须满足的状态，步骤和预期结果分行填写。

结构上建议先定三层：产品下分模块，模块下放用例；同一产品下、同一测试目的或同一运行环境的用例，可以组织成测试套件；跨产品复用的兼容性、安全、性能用例，放进公共用例库，再从用例库导入具体产品。

用例标题、前置条件和步骤怎么写

标题用“验证 + 条件 + 结果”的写法，例如“验证正确密码可以登录成功”。
前置条件只写会影响执行的状态，例如账号已注册、处于未登录状态。
每一步只放一个动作，并给出可判断的预期结果；不要把多个场景塞进一条用例。
写完后让另一位同事试读，对方能照着步骤独立执行，才算合格。

单条创建、批量录入与导入怎么选

方式	适用场景	注意点
单条创建	新功能、探索性较强的场景	字段完整，适合作为模板
多项录入	同一模块下有多条同类用例	先统一标题和步骤口径
CSV 导入	迁移历史用例	先导出模板，再按模板填充

用例评审默认关闭。团队如果要求评审，可在“后台—自定义—用例—评审流程”开启，开启后新建用例状态为“待评审”，有评审权限的人可以批量处理。

第二步：把用例组织成一张可执行的测试单

开发完成并创建构建后，在项目或迭代中提交测试。新建测试单时，填写名称、负责人、开始和结束时间，再通过“关联测试用例”从用例列表中选择。可以按构建关联的需求筛选，也可以按测试套件筛选。

测试单是把用例、执行人和时间范围绑定在一起的地方。 用例较多时，把用例指派给具体执行人，或由测试人员自行领取。提交后检查两件事：测试单状态是否为“未执行”，每条用例是否都有执行人。缺一项，后面就容易出现“有人以为别人测过了”的情况。

第三步：执行用例，让 Bug 回到同一条链路

在“测试—测试单”中打开测试单，逐条点击“执行”。结果分为通过、失败、阻塞、忽略四种。选择失败或其他非通过结果时，在“实际情况”中写清现象，必要时上传截图或日志，再保存。

失败用例可以直接“转 Bug”。填写标题、重现步骤、影响版本、严重程度和优先级，保存后，Bug 的“其他相关”里会显示来源用例。失败用例转成 Bug，而不是只留在聊天记录里，测试结果才能和修复过程对上。 用例列表里的 B、R、S 分别表示该用例产生的 Bug 数、执行次数和步骤数，可以用来快速判断哪些用例问题集中。测试单状态随执行进展更新为“进行中”或“已完成”。