PlantUML vs Mermaid：宏观对比——两种「文本画图」哲学

PlantUML 和 Mermaid 是当下最主流的两个「文本画图」工具，但它们的出身、目标和生态几乎完全不一样。这一篇从四个宏观维度对比两者——不站队，只描述差异。

一句话总结

1. 渲染引擎：JVM vs 浏览器

PlantUML 本质是 JVM 上跑的一个 Graphviz 客户端（多数图类型）。它需要一个能渲染 dot 语言的 service，常见几种部署：

• plantuml.com 公开服务（小图直接用）
• 自部署 plantuml.jar（你需要 Java 环境）
• Docker 镜像（团队自托管）
• PlantUML for VS Code 等插件（本地）

Mermaid 是纯前端 JavaScript——所有渲染逻辑在浏览器里完成，零依赖。这带来 3 个根本差异：

本质差异：PlantUML 是「发请求给渲染服务」，Mermaid 是「在浏览器里拼 SVG」。前者更重但更准，后者更轻但有边界。

2. DSL 哲学：声明式 vs 散文式

PlantUML 的语法声明式强、关注「图元素是什么」：

1
2
3
4
5
6
7
8

@startuml
class User {
  -id: Long
  -name: String
  +login(): Token
}
User --> Order: places
@enduml

Mermaid 更接近自然语言，关注「元素之间的关系怎么描述」：

1
2
3
4
5
6
7

classDiagram
  class User {
    -id: Long
    -name: String
    +login() Token
  }
  User --> Order : places

风格差异点：

• PlantUML 关键字多（+/-/-->/..>/..|>…），但严格符合 UML 教科书
• Mermaid 用 classDiagram / sequenceDiagram / flowchart 等关键字起头，主体更像 Markdown 列表
• Mermaid 更容易让非工程师写「能用的图」，PlantUML 更容易让工程师写「准确的图」

3. 平台兼容：Markdown 嵌入 vs 自托管

结论：如果你写 GitHub README / Notion / 飞书文档，Mermaid 是阻力最小的；如果你做企业内网的架构图工具链、CI 自动化、大规模批量渲染，PlantUML 是更可控的选择。

4. 扩展性：stdlib vs 注册图类型

PlantUML 的扩展靠 C4-PlantUML、Archimate、JSON / YAML、Salt 等 !include 库——你在 source/_posts/...puml 里加 !include <C4_Container> 就行，stdlib 累计 25+ 官方库。

Mermaid 的扩展靠 自定义 shape / classDef / theme——通过 classDef 改样式、flowchart 里自定义节点形状，对图的结构扩展有限。

5. 生态与维护节奏

PlantUML（2026年中）：

• 仍在维护，但版本节奏慢（一年 1-2 个 minor）
• 社区重心在「沉淀 stdlib」+ 「多语言支持」
• 性能瓶颈仍然在 Graphviz（10 年没解决）

Mermaid（2026年中）：

• 持续活跃（GitHub 上 commit 频率是 PlantUML 的 3-5 倍）
• 主版本 v11+（v12 在 2024 重写了渲染管线，性能 + 准确度大幅提升）
• 跟着 GitHub / Notion / 飞书等平台需求走

真正的差异点（一表打尽）

怎么选？

下面是一个极简决策树：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

你想在 GitHub / Notion / 飞书 文档里画图？
  → Mermaid（阻力最小）

你要画的是 UML 教科书级别的图（类图、严格时序）？
  → PlantUML（语法严格）

你需要在 CI 里批量生成 / 渲染 / 校验图？
  → PlantUML（CLI 成熟）

你的团队全是前端 / 写 Markdown 的人？
  → Mermaid（学习曲线低）

需要 C4 / Archimate / AWS / Azure 库？
  → PlantUML（25+ stdlib）

要看动画 / 交互（点击节点跳转）？
  → Mermaid v11+ click 指令 / PlantUML 交互 SVG 都支持，Mermaid 更简单

经验之谈

• 混用：很多团队的实践是「产品文档用 Mermaid，架构图用 PlantUML」
• 迁移成本：语法差异没看着大，但复杂图迁移会掉一层定制（theme、layout、注释）
• AI 友好度：两者 LLM 都强，但 Mermaid 在 GitHub Copilot / Cursor 训练集里出现频率更高
• 学习曲线：让非工程师画图——Mermaid 5 分钟；让工程师画「正确」的图——PlantUML 30 分钟

接下来的阅读

• 下一篇文章：PlantUML vs Mermaid 语法逐图对照——sequence / class / flowchart / ER / state / Gantt / C4
• 优缺点全景对比：PlantUML vs Mermaid 优缺点 + 决策树