-
Sequence diagrams: async messages and callbacks
简介 / IntroductionSequence diagrams visualize time-ordered interactions between objects. Synchronous (sync) messages block until a response arrives, while asynchronous (async) messages fire and... -
时序图：异步消息与回调
简介 / Introduction时序图（Sequence Diagram）用于展示对象之间按时间顺序交互的消息流。同步消息（sync）等待对方返回，而异步消息（async）发送后不阻塞，常用于 HTTP 请求、事件驱动架构和微服务调用场景。本文用同一业务场景，对比 PlantUML 与 Mermaid 两种引擎的语法差异。 PlantUML 版123456789101112131... -
Mermaid Gantt charts: project timelines, milestones, and dependencies
Mermaid’s Gantt chart is a project management powerhouse — describe task timelines, milestones, and dependencies in text, embed directly in docs. PlantUML’s Gantt support is weak; Mermaid is the c... -
Mermaid Gantt 图：项目管理时间线、里程碑与依赖关系
Mermaid 的 Gantt 图是项目管理神器——用文本描述任务时间线、里程碑和依赖关系，拖进文档里直接渲染。PlantUML 的 Gantt 图功能很弱，Mermaid 是这个领域的首选工具。 Gantt 图是什么Gantt 图（甘特图）用横轴=时间、纵轴=任务的方式，展示： 每个任务什么时候开始、什么时候结束 任务之间的前后依赖关系 关键里程碑在哪一天 哪些任... -
Mermaid State Diagram: state machines, transitions, and concurrent states
Mermaid’s State Diagram lets you describe state machines in plain text — faster than Visio, more precise than Flowchart for describing entity lifecycles. Ideal for: order status, user lifecycle, a... -
Mermaid State Diagram 教程：状态机、状态转换与正交状态
Mermaid 的 State Diagram（状态图）让你用文本描述状态机——比画 Visio 快，比写代码更直观。适合：订单状态流转、用户生命周期、审批流程、协议状态机。 为什么选 State Diagram 而不是 FlowchartFlowchart（流程图）描述的是过程——做什么、先做什么后做什么。State Diagram 描述的是状态——系统/实体在什么时候处于什... -
PlantUML in CI/CD: GitHub Actions auto-render, PR checks, and drift detection
PlantUML diagrams are code, but unlike regular code they have no lint/compile checks. This post covers: auto-render on every push, PR diagram diff comments, drift detection, and full CI pipel... -
PlantUML + CI/CD：GitHub Actions 自动渲染图、PR 检查与 Drift Detection
团队里 PlantUML 图越来越多，怎么保证每个人的 .puml 文件都正确渲染？PR 里的图怎么自动检查？代码变了图没同步怎么办？这一篇用 GitHub Actions 全解决。 为什么要把 PlantUML 集成到 CIPlantUML 图是代码，但它不像普通代码那样有 lint/编译检查。常见问题： .puml 文件有语法错误，上线了才发现图渲染不出来 代码改了，但忘... -
PlantUML deployment diagrams: blue-green, canary, and rolling deployments
Deployment diagrams describe the physical structure of your software — which servers, containers, and networks it runs on. PlantUML’s deployment view precisely captures servers, containers, networ... -
PlantUML 画部署图：蓝绿部署、灰度发布与金丝雀发布
部署图（Deployment Diagram）是架构评审、团队对齐、故障排查最重要的图之一。用 PlantUML 的 deployment 视图，可以精确描述服务器、容器、网络拓扑和部署策略。 部署图是什么部署图描述软件的物理部署结构——在哪台服务器上运行、用什么容器、有没有负载均衡、数据库在哪。它回答”这个系统是怎么跑起来的”这个问题。 对比： 组件图：描述软件模块之间的关系（逻辑结...