时序图

时序图(Sequence Diagram)是 UML 交互图的一种,用来按时间顺序描述参与者(用户、服务、数据库等)之间如何来回传递消息。它回答的问题是:“一次业务流程里,谁先说话、谁后回答、中间经过了哪些环节。”

横轴摆放参与者,纵轴是时间(自上而下);每条箭头就是一次消息。

元素 是什么
参与者 图顶部的方框(用户、浏览器、网关、数据库…),可写成 participant 或 actor
生命线 每个参与者下方延伸的竖虚线,表示它在这一段时间内存在
消息 参与者之间的一条箭头,表示一次调用或返回
激活条 生命线上的窄矩形,表示该对象正在处理某个请求
注释 挂在参与者旁边或两者之间的说明文字
组合片段 用框起来的 loop、alt、opt 等表示循环、分支、可选逻辑
sequenceDiagram
    participant U as 用户
    participant S as 服务端
    participant DB as 数据库
    U->>S: 提交表单
    S->>DB: 写入记录
    DB-->>S: 写入成功
    S-->>U: 跳转结果页

读法:U→>S 是用户发给服务端的请求,–» 是返回,自上而下就是时间顺序。

本站目前没有安装 Mermaid 渲染插件,上面这段只会显示成代码;装好插件后才会画成图(见 mermaid)。

sequenceDiagram
    participant A as 客户端
    actor U as 用户

书写顺序决定横轴排列的先后;actor 会画成小人图标,适合真人角色。

A->>B: 实线箭头(调用)
A-->>B: 虚线箭头(返回)
A-)B: 异步消息
A-xB: 结束或销毁消息
A->>+B: 请求
B-->>-A: 返回

+ 开启激活条,- 关闭;也可以显式写 activate B / deactivate B。

Note over A,B: 两者之间的横框说明
Note right of A: 贴在 A 右侧
Note left of B: 贴在 B 左侧
loop 每 5 分钟
    A->>B: 心跳
end
alt 校验成功
    B-->>A: 返回数据
else 校验失败
    B-->>A: 错误码
end
opt 需要缓存
    B->>C: 写缓存
end

常用的还有 par(并行)、critical(关键区)、break(中断)。

autonumber
box 内网 A,B
end

autonumber 给每条消息加序号;box 把若干参与者框成一组。

  • 第一行必须是 sequenceDiagram',少了就不会渲染。 * 冒号后有文字才是消息:只有 %%A→>B%% 而不写 : 文本 时,箭头是空的。 * 别名一致:用了 as 起别名后,后续引用要用别名,不要再用原名字。 * end 不能漏:每个 loop / alt / opt 都要有配对的 end。 * 一个代码块一张图:不要在同一段代码里画两张时序图。 * 文字里有逗号、冒号:整体加双引号更稳妥。 * 别拿它当流程图用:时序图重在顺序与调用关系,分支逻辑复杂时流程图更清楚。 ===== 五、参见 ===== * mermaid —— Mermaid 各图类型的语法速查(含时序图小节)

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 时序图.txt
  • 最后更改: 2026/10/23 18:09
  • 由 张叶安