现在很多测试新人入职第一周都会遇到同一个问题团队让我用禅道管理测试用例、提Bug可我连这个工具该怎么下手都不知道。如果你也正在经历这个阶段或者想系统把禅道测试模块用明白这篇教程就是为你准备的。禅道不只是一个Bug管理工具它是国内团队用得最多的项目管理软件之一集产品管理、项目迭代、测试管理、缺陷跟踪于一体。对测试工程师来说日常高频使用的就是测试用例和Bug模块。本文从零开始带你走完禅道测试使用的完整链路环境搭建、用例编写、执行跟踪、提Bug、出测试报告再到跟钉钉联动的进阶玩法。全部是基于我多年实际使用的经验总结不追求教科书式的罗列只讲实话、讲能落地的操作。1. 禅道测试模块到底解决什么问题1.1 从Excel到禅道测试管理的第一次升级我见过太多团队一开始用Excel管理测试用例写需求、列步骤、填预期结果一条条敲得挺认真。等用例积累到几百条或者产品迭代到第三四个版本时问题就开始集中爆发用例版本乱套同一个功能在不同Excel文件里改来改去Bug跟用例对不上提测之后开发修没修、测试回归有没有通过全靠问测试结论没有数据支撑版本能不能上线说不上来哪来的底气。禅道解决的就是这个问题。它把“需求—用例—Bug—结果”串在了一条链路上开发提交提测单你基于需求模块编写和关联用例执行后直接记录结果发现缺陷一键转Bug开发修复后你回归验证再关闭。整个过程在同一个平台上完成所有记录可追溯、可统计任何人打开禅道都能看到当前版本的真实质量状态。也有团队用Jira或者Redmine我也用过。Jira生态强大但配置复杂对中小团队来说学习成本不低Redmine则偏研发视角测试这块比较薄弱。禅道是国内团队用得最多、也是把测试闭环做得最完整的产品而且开源版本免费对初创团队和培训机构来说几乎没有上手门槛。1.2 测试工程师每天都在用的禅道功能禅道虽然功能很多但测试岗位日常高频使用的其实就四个核心模块测试用例、测试单、Bug、测试报告。你只需要把这四个模块玩熟日常工作就能完全跑起来。测试用例编写和维护用例的容器按产品、模块、需求进行组织。测试单相当于一次版本测试任务把一批用例打包分配给测试人员去执行。Bug缺陷跟踪中心从提交、确认到解决的完整生命周期都在这里管理。测试报告基于测试单和Bug数据自动生成结论用于评估版本是否具备上线条件。搞清楚这四个模块的关系后面所有操作都是顺理成章的事。我经常把禅道的测试流程比喻成做菜需求模块是菜单要做什么菜测试用例是菜谱怎么做、做到什么程度算合格测试单是后厨派工单今天谁来炒哪几个菜Bug则是炒糊了的菜要回炉重做测试报告就是这桌菜能不能上桌的质检单。这样想整套逻辑就很好理解了。2. 零基础搭建禅道环境与基础配置2.1 安装方式怎么选如果你们公司已经有运维搭好的禅道你直接拿账号登录就行可以跳过这一段。但如果你是想自己搭一套环境来练习或者负责在团队里落地禅道那先解决安装问题。禅道官方提供了三种主要安装方式Windows一键安装包、Linux一键安装包、Docker镜像。我个人的推荐顺序是自测练习用Windows一键包团队正式部署用Linux已经有容器化环境的用Docker。Windows一键安装包非常省心下载解压后运行启动服务即可内置了Apache、MySQL、PHP环境不需要你单独装任何东西。默认访问地址是http://localhost或者http://你的IP首次访问会进入初始化界面设置管理员密码、选择数据库等按提示一步步走完就行。值得注意的是新版禅道在初始化时会让你创建一个管理员账号而不是网上很多旧教程说的“默认admin/admin”如果你照着旧资料登录失败原因就在这。Linux部署建议用官方提供的一键安装脚本支持CentOS和Ubuntu系。解压后执行./zbox start启动默认端口是80如果被占用可以改用./zbox -p 8080 start来指定端口。Docker部署则更干净拉取官方镜像后做端口映射和数据卷挂载方便后续升级和备份。2.2 初始化设置产品、项目、团队的创建顺序安装完成后先别急着写用例你需要先完成三个基础数据创建产品、项目、团队。先创建产品。产品的含义是“你正在做的软件项目”比如你们公司的电商平台、内部管理系统在禅道里各算一个产品。进入后台后点击“产品”菜单新建产品填名称和代码其他字段基本可以默认。产品创建好后再去“项目”里创建迭代项目。这里有一个很多新人容易搞混的地方产品和项目有什么区别简单说产品是长期存在的比如“电商App”这个产品一直在迭代项目则是为了某个阶段目标而存在的比如“电商App双11大促版本”就是一个项目做完了就结束。同一个产品下面可以开多个项目也就是不同版本迭代。测试用例挂在产品下而测试单挂在项目下。用户和权限的设置在“组织”模块里。初始化时系统默认有管理员账号你可以批量添加团队成员分配角色项目组长、研发、测试、产品经理等。不同角色的权限差别很大比如测试经理可以创建测试单普通测试人员只能执行测试单和执行用例提交Bug的权限则默认都开放。团队规模不大时建议权限尽量收敛特别是删用例、删Bug这类危险操作只给测试组长及以上角色即可。3. 测试用例管理从手动编写到高效维护3.1 用例模块划分与编写规范用例管理是所有测试工作的地基。地基建不好后面执行和统计都是空的。我用禅道这么多年见过最典型的错误就是用例不按功能模块划分几十上百条用例全部堆在一个“默认模块”里。一旦产品功能多起来你连找一条用例都要翻半天。正确做法是在产品下先按功能模块建立一级目录再按子功能建二级目录。比如电商产品可以划分为用户端、商家端、后台管理三个大模块用户端下面再细分注册登录、商品列表、购物车、订单支付、个人中心等子模块。禅道支持无限层级模块建议控制在三级以内层级太深反而增加维护成本。编写用例时字段要完整。禅道的用例字段包括所属产品、所属模块、关联需求、用例标题、优先级、用例类型功能测试、性能测试、接口测试等、前置条件、步骤、预期结果。步骤和预期结果必须一一对应这是用例编写的核心要求。很多新手写预期结果特别含糊比如“页面正常显示”这种话开发看了不知道标准你自己执行时也拿不准算不算通过。正确写法是明确到具体表现例如“点击登录按钮后跳转到首页右上角显示用户手机号”。3.2 Excel批量导入导出告别一条条手敲团队第一次从Excel迁移到禅道时几百条用例不可能一条条手工录入。禅道内置了Excel导入导出功能其实完全可以一键解决。导出操作非常简单在用例列表页面选择想要导出的用例点击“导出”按钮选择模板即可。导入则要注意格式禅道支持关联需求和多步骤导入。官方提供了Excel导入模板你下载模板后按字段填充注意“步骤”列用多行格式一行写一个步骤预期结果也和步骤一一对应每条用例之间用编号区分。填好后选择导入系统会先做数据校验显示哪些行有问题按提示修正后再提交。这里必须提醒一句导入前先确认好用例模块的层级结构因为Excel里需要填写“所属模块”字段如果模块在禅道里还不存在导入很容易失败。所以先建模块再导数据这个顺序不能乱。3.3 用例评审和用例库团队协作的关键用例写出来不是给自己看的而是要跟团队对齐的。禅道支持用例评审你可以在用例列表里勾选需要评审的用例发起评审流程。评审人可以设置成产品经理、开发、测试主管等。每个用例可以有评审结果通过、继续改进、不予通过。这一机制能有效防止用例写偏、写漏尤其在功能复杂的大版本里用例评审能省下后面冒烟测试的大把时间。还有不少团队容易漏掉的一个功能是用例库。用例库和普通用例的差别在于普通用例跟着迭代项目走项目结束后用例随项目归档而用例库里的用例是长期维护的可以在多个项目、多个版本里复用。对于回归重点场景、线上高频用例我建议在完成首轮功能验证后把核心用例同步一份到用例库。下次开发提测新版本时直接从用例库里一键导入所需用例再补充新增功能的用例效率会高很多。4. Bug管理提一个让开发无法反驳的Bug4.1 提Bug的标准动作和关键字段Bug模块是禅道里测试人员使用频率最高的地方也是开发与测试“打交道”最多的入口。一个高质量的Bug能让开发快速定位问题、减少来回沟通也能体现测试的专业度。提Bug时必填字段用心填好尤其这几项影响版本选择当前提测的版本号这块不填清楚开发根本不知道你测的是哪一版代码。严重程度1级是系统崩溃、数据丢失2级是主要功能不可用3级是一般功能异常4级是轻微界面问题5级是建议。不要把所有问题都提交成3级区分好严重程度才能推动优先级。优先级1最紧急、4最低这个字段决定开发先修哪个测试对Bug价值的判断就体现在这里。Bug类型是代码错误、需求变更还是界面优化、配置问题、性能问题。正确归类Bug类型便于后续统计分析时针对性复盘。重现步骤用最精简的路径写清操作顺序预期结果和实际结果分开展示。开发修复Bug时第一步必然是照着重现步骤复现问题如果你的步骤写得含糊整个流转都会被拖慢。除了必填字段建议在Bug描述里附上截图、日志、接口返回信息。禅道支持直接粘贴剪贴板图片到富文本编辑器也支持上传附件。我在团队里要求测试人员提交Bug时至少附一张实测截图核心流程的Bug必须附带浏览器F12里的请求日志这能帮开发减少大量无效沟通。4.2 Bug生命周期与状态流转规则禅道的Bug状态流程是这样的测试人员提交Bug时Bug处于“激活”状态开发确认后在“解决”阶段选择解决方式比如“已修复”、“设计如此”、“重复Bug”、“外部原因”、“不予解决”等并填写备注说明然后Bug流转回测试环节你验证通过后点“关闭”验证不通过就“重新激活”打回给开发。看起来很简单但实际协作中总会出现状态被乱改的情况。两个最重要的注意事项一是解决方式为“设计如此”的Bug测试一定要确认产品经理是否认可这个结论而不是开发单方面说了算二是“重复Bug”必须写清楚被重复的原始Bug编号方便其他人追溯。禅道还支持在Bug详情页关联需求、关联用例这样后续查看Bug时能直接跳到对应的功能和测试记录。另外禅道内置了Bug确认机制。开启之后开发不能直接解决问题需要先把Bug设置成“已确认”状态再进入解决阶段。这个机制适合“开发随手关闭Bug”这种失控场景测试主管可以从后台打开强制确认选项。4.3 从Bug数据看版本质量Bug提交多了数据本身就会产生价值。禅道的“测试”菜单里提供了Bug统计报表按产品、模块、严重程度、指派给等维度展示Bug分布情况。我最常用的三个报表是按优先级统计的Bug金字塔、按模块统计的Bug热区、按日期统计的Bug趋势。Bug金字塔看的是缺陷严重程度分布。一个健康的版本通常是3级Bug最多1级和2级很少如果1级2级Bug占比过高说明这次提测代码质量堪忧。Bug热区则是用来暴露模块质量洼地比如说某个模块连续几个版本Bug数量都排第一就要提醒研发负责人重点排查这个模块的技术债。Bug趋势图可以帮助测试负责人在版本提测初期判断开发修Bug的响应速度如果提交量持续上涨而解决量停滞那就需要及时上报项目风险了。5. 测试单、执行与测试报告打通测试流程闭环5.1 如何创建和执行一次测试单测试单在禅道里是一个非常重要的概念它把一次版本测试任务的用例、人员、时间、结果全部串起来。开发提测后测试负责人在“测试”菜单里新建测试单选择所属产品、关联项目然后从产品用例库里勾选本次要执行的用例。可以全量选也可以按模块勾选重点用例。接着设置开始日期和结束日期指派给具体执行人。一个测试单可以关联多个执行人比如A测用户端、B测后台管理分工明确。执行人登录后在自己的待办里就能看到被指派的测试单。打开测试单一条条执行关联用例每个用例都标记执行结果通过、失败、阻塞、待执行。失败的用例可以选择“转Bug”系统自动带入当前用例的标题和步骤你只需补充严重程度等信息就可以提交。这里有个效率技巧不用每条用例提交完之后再单独去建Bug直接在用例执行界面点“转Bug”即可Bug会自动跟用例关联上后面追踪回归也方便。执行过程中如果遇到用例本身写得不合理比如预期结果和实际需求不一致可以修改用例内容并保留历史记录。禅道的用例版本管理功能会在你每次修改时记录差异这点对多人协作特别重要。5.2 测试结论怎么定测试报告怎么出当测试单的所有用例执行完毕测试负责人需要对整个测试单给出结论。禅道提供测试结论选项通过PASS、不通过FAIL、有阻塞BLOCK。我的建议是结论必须结合通过率和遗留Bug两个维度来下不能只看通过率。比如用例通过率95%但剩下的5%里有一个1级严重程度的崩溃Bug那这个版本仍然不能判PASS必须等开发修复后回归通过才能放行。反过来通过率虽然只有90%但未通过的都是界面文案、布局错位等4级5级问题且产品经理确认可以遗留到下个版本那么测试结论也是可以判PASS的。测试单执行完后点击“生成报告”按钮禅道会基于测试单执行记录、用例通过率、Bug数据自动汇总成一份测试报告。报告内容能涵盖测试范围、用例执行情况、Bug分布、遗留缺陷清单、测试结论等。你可以在报告模板里加上版本风险和建议再导出成Word或HTML发给全组和相关方。这份报告就是测试对版本质量最正式的表态认真写养成习惯你的专业度会直接体现出来。5.3 与研发、产品的协作联动禅道把开发提测、测试验证、产品验收的协作都串在了同一条链路上。开发提交提测单时可以关联需求、代码版本和构建信息测试执行测试单时能看到对应的需求和代码改动范围这样设计用例时就有据可依Bug提交后开发在“我的Bug”里直接处理处理结果自动通知到测试。整个流程不用靠口头沟通、不用翻聊天记录所有数据都在禅道里闭环。这种联动也改变了测试人员在团队里的沟通方式。以前是“这个Bug你能不能看看”现在是“Bug编号1234严重程度2级日志和截图都附上了麻烦今天修完重新提测”。工作留痕责任明确扯皮的次数直线下降。6. 进阶技巧与常见问题排查6.1 禅道与钉钉集成通知和跳转一步到位很多团队日常沟通都在钉钉上如果禅道的Bug、测试单消息只能在网页里看测试和开发很容易漏掉任务提醒。禅道官方支持钉钉集成配置完成后开发被指派处理Bug、测试被指派执行测试单都会收到钉钉消息提醒并且消息里直接提供跳转链接点一下就能打开对应页面。配置方法不复杂先在钉钉开发者后台创建一个企业内部应用拿到AppKey和AppSecret然后在禅道后台的“通知”设置里填入这些信息选择要推送的事件类型Bug指派、Bug解决、测试单指派等保存后做一次测试推送验证即可。不同版本的禅道界面可能略有差异但整体流程是一致的。钉钉集成带来的效果立竿见影Bug从提交到被开发看到的时间从“看运气”变成“秒级”。这也让你在提完Bug之后不用再额外私聊提醒开发通知由系统代替完成谁漏处理了也一目了然。6.2 禅道使用常见问题速查在我带团队的过程中禅道用得久了总会碰到一些重复出现的问题。这里整理一份高频问题清单实测有效登录后白屏或页面样式错乱通常是浏览器缓存问题强制刷新CtrlF5或者换个浏览器无痕模式登录。忘记管理员密码可以通过命令行工具重置禅道自带zbox管理脚本使用./zbox resetPasswd可以重置admin密码。附件无法上传检查上传目录写权限Linux环境常见需要把www/data/upload目录设置为可写。并发数高时页面响应慢把Apache的并发配置调大或者升级到更高版本官方在性能调优文档里给了参数建议。数据库备份测试数据虽然不像生产数据那么重要但用例和Bug记录丢失也够让人抓狂的。禅道自带备份功能后台设置定期自动备份即可建议每天备份一次保留最近7天。6.3 团队推行禅道的落地经验最后聊聊长期使用禅道的一些体会。团队刚上禅道时最容易遇到的问题不是工具不会用而是流程没人定义清楚。我见过不少团队把禅道当成高级记事本需求不上系统、提测不走测试单、Bug随手填标题结果几个月后数据一塌糊涂又跑回去用Excel。要避免这个局面负责人需要在推行前就定好三条规则第一提测必须走测试单没有测试单的版本一律不测第二Bug标题和描述必须达到最小信息完整标准不达标自动打回第三测试结论不能口头说测试报告必须从禅道生成并留档。规则定好前一个月执行得严格一点后面大家形成习惯效率会有肉眼可见的提升。另外禅道每个版本都有更新新功能可能正好解决你团队当前的痛点。每隔一段时间去官网看看版本发布说明说不定会有惊喜。从我个人的实际体验来说禅道最值得肯定的不是单一功能有多强大而是把测试工作从“点状的执行动作”变成了“可追溯、可度量、可复盘的闭环体系”。刚开始学禅道的时候你也许觉得多点几下鼠标有点麻烦但坚持两个月当你打开测试报告、看着Bug趋势图和用例通过率能理直气壮地说出这个版本能不能上线时你就会发现这套工具流程的价值所在了。