PlantUML 入门：为什么它值得放进你的工具箱

这篇文章是 puml.online 站点的开篇文章，由 AI 辅助起草，仅作为内容示例。你可以参考它的结构、风格和节奏，写出真正属于你的内容。

什么是 PlantUML

PlantUML 是一种用纯文本描述来画图的工具。你写一段类似代码的标记，PlantUML 引擎把它渲染成 UML 图（PNG、SVG、PDF 都行）。

1
2
3
4

@startuml
Alice -> Bob: 你好
Bob --> Alice: 收到
@enduml

上面这段就能画出一个简单的时序图。

它能画哪些图

加上几行配置还能画 ER 图、JSON、YAML 树、思维导图、网络拓扑等十几种。

为什么要用 PlantUML

• 可版本管理：图就是文本，能 git diff，能放进 code review
• 可复用：模板化，团队成员共用
• 可自动化：CI 里跑 plantuml CLI，每次发版自动生成最新架构图
• 不挑平台：Java 写的，几乎所有系统都能跑；也有 WebAssembly 版本，浏览器里直接画
• 生态好：VSCode、IntelliJ、Confluence、GitLab/GitHub 都有插件

怎么开始

最快的三种方式：

1. 在线版：plantuml.com/plantuml，打开就能用
2. VSCode 插件：搜 “PlantUML”，装上之后写 .puml 文件就能预览
3. 本地 CLI：需要 Java 11+，装完 plantuml diagram.puml 就出 PNG/SVG

跟其他工具的对比

• draw.io / Visio：拖拽，画得漂亮但不能 diff，写大项目维护成本高
• Mermaid：语法类似，纯 JS，GitHub/GitLab 原生支持；但支持的图类型比 PlantUML 少
• Structurizr DSL：C4 模型专用，更结构化，但学习曲线更陡

我的看法：日常画图用 Mermaid 就够了；做架构图、复杂时序图、状态机，PlantUUM 胜出。

下一篇我会给 5 个最常用的图模板，复制就能用。