一、用例图回答什么问题
一句话:谁用这个系统做什么。
三个元素,不多不少:
| 元素 | 画法 | 含义 |
|---|---|---|
| 参与者(Actor) | 火柴人 | 与系统交互的人或外部系统 |
| 用例(Use Case) | 椭圆 | 系统提供的一个完整功能 |
| 系统边界 | 矩形框 | 系统的范围 |
二、参与者怎么找
2.1 找人的三个问法
- 谁使用系统的主要功能?(买家、卖家、学生、教师)
- 谁负责维护系统?(管理员)
- 谁需要从系统获取信息?(外部对接的系统)
2.2 常见错误
错误:把"用户"当一个参与者
❌ 只有"用户"和"管理员"两个火柴人
正确:按角色权限区分
✅ 普通用户、认证卖家、管理员、(可选)访客
角色划分体现你的权限设计,太笼统会被问"你的权限模型是怎么设计的"。
错误:把系统模块当参与者 参与者是人或外部系统,不是"数据库"、"后台"。
2.3 外部系统也能当参与者
如果系统要对接第三方(短信服务、支付网关、地图 API),把它们画在系统边界框外面,用连线连到对应用例。这体现你考虑了集成。
三、用例怎么定
3.1 用例必须是"完整的功能目标"
判断标准:参与者发起后,系统能交付一个完整结果。
- ✅ 发布商品、下单、评价订单、申请退款
- ❌ 输入用户名(这是步骤,不是用例)
- ❌ 点击提交按钮(这是操作,不是用例)
- ❌ 查询商品(太细,除非是核心检索功能)
3.2 用例命名
动词 + 名词:"发布商品"、"评价订单"、"处理举报"。
不要写成"商品管理模块"——模块是功能结构图的东西。
3.3 数量控制
单张用例图 8~15 个用例比较合适。超过 20 个说明粒度太细,或者应该拆成多张图(按角色分图)。
四、系统边界框要不要
要画。 一个矩形框把用例圈起来,参与者放在框外。
原因:它明确表达"这些功能在系统内部实现",参与者是外部交互方。不画框的图在规范评分里会被扣,因为分不清边界。
框的顶部可以标系统名:校园二手交易系统。
五、include 与 extend:什么时候用
工具边界:本站 UML 工具当前只绘制参与者—用例的实线关联,不支持 include/extend 的虚线箭头和
<<include>>/<<extend>>标签。需要这两类关系时,请导出 Draw.io 后在 Draw.io 中补,或使用 PlantUML/Visio。
这两个关系最容易用错。
5.1 include(包含)
含义:这个用例一定会用到另一个用例。
方向:从基用例指向被包含的用例,虚线箭头,标 <<include>>。
典型场景:多个用例都需要"登录校验"。
发布商品 ──<<include>>──→ 身份校验
下单 ────<<include>>──→ 身份校验
评价 ────<<include>>──→ 身份校验
判断问法:去掉被包含的用例,基用例还能完整执行吗?不能 → 用 include。
5.2 extend(扩展)
含义:在某些条件下才发生的附加行为。
方向:从扩展用例指向基用例,虚线箭头,标 <<extend>>。
典型场景:下单时可以选择用优惠券。
使用优惠券 ──<<extend>>──→ 下单
判断问法:这个行为是可选的、有时才发生吗?是 → 用 extend。
5.3 一句话区分
| 关系 | 是否必然 | 箭头方向 |
|---|---|---|
| include | 必然发生 | 基用例 → 被包含用例 |
| extend | 条件发生 | 扩展用例 → 基用例 |
箭头方向反了是最高频的错误,评阅老师一眼能看出来。
六、八个高频错误
- 箭头方向反了(extend 画成基用例指向扩展用例)
- 把步骤当用例("输入密码")
- 参与者只有"用户"和"管理员"
- 不画系统边界框
- 用例之间画了实线箭头(关联用实线无箭头,include/extend 用虚线箭头)
- 用了泛化关系但说不清理由(本科尽量不用)
- 一个用例连了五个参与者(说明粒度太粗,应拆)
- 与功能结构图对不上(用例图有的功能结构图里没有)
七、画图工具
| 工具 | 说明 |
|---|---|
| Visio | 可以,模板多 |
| Draw.io | 免费,手动对齐 |
| PlantUML | 写代码生成,风格统一但不便微调 |
| 本站 UML 用例图工具 | 标准火柴人、系统边界框、参与者—用例关联线,支持从功能结构图一键流转;include/extend 需导出 Draw.io 后手动补 |
实用流程:先在 功能结构图工具 里把模块拆好,再一键转成用例图;在 UML 工具里核对参与者、用例和边界并导出 Draw.io;最后在 Draw.io 中补 include/extend 虚线和标签。这样两张图天然一致。
工具右侧“参数与样式”可以改系统边界标题、显示/隐藏边界框;工具栏“适配”可一键看全图。导出条件以工具页当前显示为准;积分工具会先确认扣分,有效畅享卡可免扣。
八、配套要写什么
用例图不能单独存在,第 2 章还需要:
- 参与者说明表:每个角色能做什么
- 用例描述:挑 3~5 个核心用例,写清前置条件、基本流程、异常流程、后置条件
- 功能性需求表:编号 / 名称 / 描述 / 优先级
只有图没有文字说明,会被批"需求分析不深入"。
九、自查清单
- 参与者 3 个以上,按角色权限区分
- 画了系统边界框,参与者都在框外
- 用例名是动宾短语,不是模块名
- include 指向被包含,extend 指向基用例(箭头别反;用本站工具时需在 Draw.io 中补)
- 用例数与第 3 章功能结构图的模块数对得上
- 有配套的参与者说明和用例描述
- 图题在下方,编号连续(图 2-1、图 2-2)
功能结构图怎么画见 第 3 章功能结构图画法;整章需求分析需要重做可以看论文写作服务。