差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

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

该主题尚不存在

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

  • 时序图.1792748259.txt.gz
  • 最后更改: 2026/10/23 17:37
  • 由 张叶安