差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 时序图 [2026/10/23 17:37] – 创建 张叶安 | 时序图 [2026/10/23 18:09] (当前版本) – 补全正文:时序图(UML 交互图)的概念、元素与 Mermaid 语法 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | 1 | + | ====== 时序图 ===== |
| + | |||
| + | **时序图**(Sequence Diagram)是 UML **交互图**的一种,用来按**时间顺序**描述参与者(用户、服务、数据库等)之间如何来回传递消息。它回答的问题是:“一次业务流程里,谁先说话、谁后回答、中间经过了哪些环节。” | ||
| + | |||
| + | 横轴摆放参与者,纵轴是时间(自上而下);每条箭头就是一次消息。 | ||
| + | |||
| + | ===== 一、核心元素 ===== | ||
| + | |||
| + | ^ 元素 ^ 是什么 ^ | ||
| + | | 参与者 | 图顶部的方框(用户、浏览器、网关、数据库…),可写成 '' | ||
| + | | 生命线 | 每个参与者下方延伸的竖虚线,表示它在这一段时间内存在 | | ||
| + | | 消息 | 参与者之间的一条箭头,表示一次调用或返回 | | ||
| + | | 激活条 | 生命线上的窄矩形,表示该对象正在处理某个请求 | | ||
| + | | 注释 | 挂在参与者旁边或两者之间的说明文字 | | ||
| + | | 组合片段 | 用框起来的 '' | ||
| + | |||
| + | ===== 二、最小示例 ===== | ||
| + | |||
| + | < | ||
| + | sequenceDiagram | ||
| + | participant U as 用户 | ||
| + | participant S as 服务端 | ||
| + | participant DB as 数据库 | ||
| + | U->> | ||
| + | S->> | ||
| + | DB-->> | ||
| + | S-->> | ||
| + | </ | ||
| + | |||
| + | 读法:'' | ||
| + | |||
| + | 本站目前没有安装 Mermaid 渲染插件,上面这段只会显示成代码;装好插件后才会画成图(见 [[mermaid]])。 | ||
| + | |||
| + | ===== 三、常用语法 ===== | ||
| + | |||
| + | ==== 参与者 ==== | ||
| + | |||
| + | < | ||
| + | sequenceDiagram | ||
| + | participant A as 客户端 | ||
| + | actor U as 用户 | ||
| + | </ | ||
| + | |||
| + | 书写顺序决定横轴排列的先后;'' | ||
| + | |||
| + | ==== 消息类型 ==== | ||
| + | |||
| + | < | ||
| + | A->> | ||
| + | A-->> | ||
| + | A-)B: 异步消息 | ||
| + | A-xB: 结束或销毁消息 | ||
| + | </ | ||
| + | |||
| + | ==== 激活条 ==== | ||
| + | |||
| + | < | ||
| + | A->> | ||
| + | B-->> | ||
| + | </ | ||
| + | |||
| + | '' | ||
| + | |||
| + | ==== 注释 ==== | ||
| + | |||
| + | < | ||
| + | Note over A,B: 两者之间的横框说明 | ||
| + | Note right of A: 贴在 A 右侧 | ||
| + | Note left of B: 贴在 B 左侧 | ||
| + | </ | ||
| + | |||
| + | ==== 组合片段 ==== | ||
| + | |||
| + | < | ||
| + | loop 每 5 分钟 | ||
| + | A->> | ||
| + | end | ||
| + | alt 校验成功 | ||
| + | B-->> | ||
| + | else 校验失败 | ||
| + | B-->> | ||
| + | end | ||
| + | opt 需要缓存 | ||
| + | B->> | ||
| + | end | ||
| + | </ | ||
| + | |||
| + | 常用的还有 '' | ||
| + | |||
| + | ==== 自动编号与分组 ==== | ||
| + | |||
| + | < | ||
| + | autonumber | ||
| + | box 内网 A,B | ||
| + | end | ||
| + | </ | ||
| + | |||
| + | '' | ||
| + | |||
| + | ===== 四、常见坑 ===== | ||
| + | |||
| + | * **第一行必须是 '' | ||
| + | * **冒号后有文字才是消息**:只有 %%A->> | ||
| + | * **别名一致**:用了 '' | ||
| + | * **'' | ||
| + | * **一个代码块一张图**:不要在同一段代码里画两张时序图。 | ||
| + | * **文字里有逗号、冒号**:整体加双引号更稳妥。 | ||
| + | * **别拿它当流程图用**:时序图重在顺序与调用关系,分支逻辑复杂时流程图更清楚。 | ||
| + | |||
| + | ===== 五、参见 ===== | ||
| + | |||
| + | * [[mermaid]] —— Mermaid 各图类型的语法速查(含时序图小节) | ||