教程

Mermaid 状态图指南:用代码建模系统行为

2026年6月18日
1 分钟阅读
mermaid2img

状态图可视化系统如何在不同状态间响应事件而转换。对于建模用户界面、订单生命周期、认证流程等具有明确状态和转换的过程至关重要。

Mermaid 状态图让你用文本代码定义这些模型 — 可版本控制、AI 友好、即时渲染。

基础语法

元素语法示例
起始状态[*][*] --> FirstState
结束状态[*]LastState --> [*]
转换-->StateA --> StateB : event

电商订单状态机示例

复合状态

最佳实践

  1. 状态名使用 PascalCase
  2. 转换标签用过去式事件名
  3. 保持 15 个状态以内
  4. 用复合状态分组相关转换
  5. 在 Mermaid2Img 中验证后再嵌入文档

导出状态图

将代码粘贴到 Mermaid2Img 预览并导出 PNG、SVG 或 PDF。

常见问题

状态图和流程图有什么区别?

流程图展示处理步骤和决策。状态图展示实体如何在定义的状态间响应事件转换。

能在 GitHub README 中使用吗?

可以。GitHub 原生支持 Mermaid 状态图渲染。