社区所有版块导航
Python
python开源   Django   Python   DjangoApp   pycharm  
DATA
docker   Elasticsearch  
aigc
aigc   chatgpt  
WEB开发
linux   MongoDB   Redis   DATABASE   NGINX   其他Web框架   web工具   zookeeper   tornado   NoSql   Bootstrap   js   peewee   Git   bottle   IE   MQ   Jquery  
机器学习
机器学习算法  
Python88.com
反馈   公告   社区推广  
产品
短视频  
印度
印度  
Py学习  »  Git

GitHub 2.5万 Star!这款开源画图神器,让我彻底抛弃了 PlantUML

芋道源码 • 2 周前 • 104 次点击  

👉 这是一个或许对你有用的社群

🐱 一对一交流/面试小册/简历优化/求职解惑,欢迎加入「芋道快速开发平台」知识星球。下面是星球提供的部分资料: 

👉这是一个或许对你有用的开源项目

国产Star破10w的开源项目,前端包括管理后台、微信小程序,后端支持单体、微服务架构

RBAC权限、数据权限、SaaS多租户、商城、支付、审批工作流、大屏报表、ERP、 CRM、WMS、MES、EAM、HRM、OA、FMS、PMS、AI大模型、AI工作流、AI Agent、IoT物联网、IM实时聊天等功能:

  • 多模块:https://gitee.com/zhijiantianya/ruoyi-vue-pro
  • 微服务:https://gitee.com/zhijiantianya/yudao-cloud
  • 视频教程:https://doc.iocoder.cn
【国内首批】支持 JDK25 + SpringBoot4、JDK17/21+SpringBoot3、JDK8/11+Spring Boot2三版本 

QUOTE

你写文本,它出图。

画架构图、ER 图、部署图的人,大概都跟 PlantUML 或 Mermaid 打过交道。简单场景够用,图一复杂就开始折磨人。

D2 是另一条路。声明式图表脚本语言,你写文本,它出图,缩进表示层级,箭头表示连线。

项目两万五千多 Star,Go 写的,MPL 2.0 协议,CLI 一条命令就能装。装完不依赖任何运行时,不用为了画一张图去装 JDK,也不用起一个浏览器。

— d2lang/d2 仓库首页,Star 与许可证

我更愿意把它的赌注说清楚。老工具的验收标准是「能出图」,D2 的验收标准是「不调就好看」。三个布局引擎、一整套内置主题、精确到行的报错,全是冲着后一条去的。

「不调」这两个字不是修辞。官方那张招牌例子里,卫星图标自动排成一列、存储节点自动变成圆柱、容器自动套虚线框,这些都不是手写的样式,是渲染时按语义给的默认值。你只描述了它是什么,它自己决定长什么样。

本文看点

01

三个字母,一张图

02

老工具卡在哪

03

不调就好看,靠的是什么

01

SYNTAX

三个字母,一张图

最基础的例子只有一行。

···d2

x -> y -> z

三个字母,出来一张有向图。

— x 指向 y,y 指向 z

真正让它跟别的工具分开的是嵌套写法。你在文本里看到的层级,就是图里的层级。

···d2

network: {

 cell tower: {

  satellites: {

   shape: stored_data

   style.multiple: true

  }

  transmitter

 }

}

network 包含 cell tower,cell tower 包含 satellites,父子关系不用单独声明,缩进就定死了。

— 缩进结构等于图里的容器嵌套

这点写法在 Mermaid 和 PlantUML 里要绕一圈。它们也能做容器,但要额外写 subgraph 或 package,层级和代码结构对不上,改起来容易错位。

常用语法都在同一套里。给节点加标签写 a: 数据库,改形状写 a.shape: cylinder,给连线加说明写 a -> b: 调用。图标可以直接贴 URL,D2 会把它嵌进导出的 SVG,不用另存本地文件。

···d2

api: {

 shape: hexagon

 style.fill: "#eef2ff"

}

db: 主库 { shape: cylinder }

api -> db: 读写

形状、颜色、连线说明写在同一个文件里,改完刷新就能看到。这种「描述即所得」的节奏,是它跟拖拽工具拉开差距的地方。

写完保存,跑一句 d2 --watch in.d2 out.svg,浏览器自动刷新。改一个字,图立刻变,手感跟前端的热更新一样。写大图的时候这个体验差别特别明显,不用每次手动编译再看结果。

ruoyi-vue-pro

基于 Spring Boot + MyBatis Plus + Vue & Element & Ant Design 实现的后台管理系统 + 用户小程序,RBAC权限、数据权限、SaaS多租户、商城、支付、审批工作流、大屏报表、ERP、CRM、WMS、MES、HRM、EAM、OA、FMS、PMS、AI大模型、AI工作流、AI Agent、IoT物联网、IM实时聊天等功能

项目地址:https://github.com/YunaiV/ruoyi-vue-pro

视频教程:https://doc.iocoder.cn/video/


02

COMPARISON

老工具卡在哪

先说 PlantUML。画时序图它还行,画架构图就是在跟布局引擎打架。你定义了 A 包含 B,B 连到 C,出来的图里 B 跑到 A 外面去了,C 被挤到画布右下角。想调,就得往代码里塞 skinparam、ortho 和各种方向参数,调完还不一定对。

Mermaid 的痛点不一样。GitHub 原生渲染它,这是它最大的护城河,README 里贴一段代码就自动出图。但节点一多,布局基本失控,而且你没有任何办法把某个节点挪到想要的位置。

同样一张两层的图,Mermaid 要这么写。

···mermaid

flowchart TD

 subgraph 订单

  A[下单] --> B[扣库存]

 end

 subgraph 支付

  C[收款]

 end

 B --> C

换成 D2,层级直接由缩进决定,subgraph 这个词根本不用出现。

···d2

订单: {

 下单 -> 扣库存

}

支付: {

 收款

}

订单.扣库存 -> 支付.收款

还有一个被忽略的问题,错误提示。PlantUML 报错经常只有一句 Syntax Error,后面跟个问号。你盯着三百行代码找二十分钟,发现少了个引号。Mermaid 好一点,但也只是好一点。

环境也是门槛。PlantUML 依赖 Java 运行时,想在 CI 里自动生成架构图,得先装 JRE,再配 Graphviz,然后祈祷版本兼容。Graphviz 的 DOT 语言更直接,1991 年的设计,语法像考古现场,画出来的图自带一股学术论文味,放进产品文档里设计师会跟你急。

这些问题的根子在一个地方。自动布局本身是个很难的优化问题,节点一多,求「好看的解」和求「能出图的解」完全是两码事。老工具把这件事交给各自的布局库,用户只能在结果不理想时手动打补丁。D2 换了个做法,把布局当成自己的核心能力去迭代,用户看到的只是「换了个引擎,图顺了」。

现在的主流工具摆在一起,差别一目了然。

开源协议这栏,D2 是 MPL 2.0,Mermaid 是 MIT,PlantUML 是 GPL 3.0,Graphviz 是 EPL 1.0。发布时间分别是 2022、2015、2009 和 1991。

实现语言上,D2 用 Go,Mermaid 用 JS,PlantUML 用 Java,Graphviz 用 C。四家都有 CLI,除了 Mermaid 都不需要浏览器。

工程化能力差得最开。自动格式化和友好错误提示,只有 D2 有。内置主题和 Markdown 支持,D2 与 Mermaid 都有。

特殊能力各有一手。动画支持只有 D2 有,GitHub 原生渲染只有 Mermaid 有,LaTeX 支持也是只有 D2 有。

这组对比来自 text-to-diagram.com,Terrastruct 维护的对比站,也是目前最完整的一份。

看下来会发现,老工具的问题不是功能少。它们的设计理念停在「把图画出来就行」,从没考虑过画图这个过程本身有多折磨人。

yudao-cloud

基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element & Ant Design 实现的后台管理系统 + 用户小程序,RBAC权限、数据权限、SaaS多租户、商城、支付、审批工作流、大屏报表、ERP、CRM、WMS、MES、HRM、EAM、OA、FMS、PMS、AI大模型、AI工作流、AI Agent、IoT物联网、IM聊天等功能

项目地址:https://github.com/YunaiV/yudao-cloud

视频教程:https://doc.iocoder.cn/video/


03

LAYOUT

不调就好看,靠的是什么

自动布局是文本绘图的核心。语法再顺手,布局烂就是废物。D2 内置三个引擎,都能直接切。

···d2

vars: {

 d2-config: {

  layout-engine: elk

 }

}

Dagro 是默认那个,Dagre 的 Go 原生移植,适合层级分明的图。elk-go 也是 Go 移植,处理节点多、连线绕的图更稳。TALA 是专为软件架构图写的,默认不开,需要显式指定。

切换有三种写法。命令行加 --layout=elk,环境变量设 D2_LAYOUT=elk,或者在文件头写 vars.d2-config.layout-engine: elk。团队协作建议写在文件里,谁 clone 下来跑出来都一样。想看当前版本支持哪些引擎,跑一句 d2 layout 会列出来。

同一个文件换个引擎,出来的排布能差很远。层级简单的图,Dagro 排得最干净;节点多、连线交叉的图,elk-go 明显更少打结;TALA 对带容器的大型架构图最见功力。这也是它比只有一套布局的老工具更耐用的原因,不满意还能换一种算法,不用重新排版。

这里有个刚变的事。TALA 以前是商业版,要单独装插件、填 license key,免费版还有功能裁剪。从 v0.9.0 起它开源并内置进 D2 ,--layout=tala 就能用,不需要插件也不需要密钥。这一点很多老文章还在写旧口径。

— 同一个文件,左边代码右边图

主题是另一件被低估的事。D2 内置一整套正式主题,从浅色到深色,从克制到鲜明,切一行配置就换。

— 内置主题的编号与配色

不用像 PlantUML 那样写几十行 skinparam 去调颜色、字体和圆角。这些主题是设计师做的,不是程序员随手配的色板。颜色只是其中一项,字体、线宽、阴影和箭头样式会一起跟着变,所以不会出现颜色对了但线条还是廉价的那种尴尬。

字体默认是 Source Sans Pro。标签里能直接写 LaTeX 公式,渲染走的是 mathjax-go 的 Go 移植,不依赖浏览器。另外还有个 sketch 模式,手绘风格,早期方案讨论时比正式框图更有亲和力。

报错这一块差距最明显。D2 的 parser 会尽量把错误收集齐再报,告诉你第几行、什么问题、大致怎么改,而不是遇到第一个就罢工。有一次我写了 x -> 就换行,它直接指出第几行箭头后面缺目标节点,看一眼就改完了。同样的错在 PlantUML 里只会得到一句 Syntax Error,你还得自己数行。

加上自动格式化,写 D2 的体验更接近写代码,而不是在跟一个黑盒较劲。


04

INTEGRATIONS

除了画图,它还能干什么

插件是它落地最快的地方。官方给了 VSCode、Vim、Obsidian 三个,社区把 Confluence、Maven、Pandoc、MkDocs、VitePress、Zed 这些都补齐了。写文档时直接嵌 d2 代码块,预览跟着变。

对团队来说,Confluence 和 Maven 那两个最实用。前者让 wiki 里的架构图能跟着版本走,后者在打包阶段就把图生成好,不用谁记着手动更新。

它还能当 Go 库用。CI 里跑完测试顺手生成一张架构现状图,或者扫一遍数据库 schema 自动出 ER 图,这类批量化场景是原生支持的,不用绕命令行。

···go

import (

  "github.com/d2lang/d2/d2compiler"

  "github.com/d2lang/d2/d2renderers/d2svg"

)

注意包路径跟着仓库一起搬了。老教程里写的 oss.terrastruct.com/d2 已经是过去式,现在模块路径是 github.com/d2lang/d2。

动画是它的独门。定义一个文件的多个 step,导出的是带过渡效果的 SVG,一张图讲完架构怎么演进。做技术分享的时候,不用再画三张图,也不用在 PPT 里做动画。

···d2

steps: ["0", "1", "2"]

甲 -> 乙 { style.animated: true }

导出现在覆盖 SVG、PNG、GIF、PDF 和 PPTX,都是内置渲染器在做,不依赖外部工具链。

用它的项目也不缺。ElasticSearch、Sourcegraph、Temporal、Tauri、IntelliJ 的仓库里都有 .d2 文件,这比任何宣传都好使。


05

LIMITS

它的短板和最新的变化

GitHub 不原生渲染  D2。这是 Mermaid 的护城河,短期谁也跨不过去。想在 README 里直接出图,得在 CI 里生成 SVG 再提交,或者用社区插件绕。

实际做法一般是两步。仓库里存 .d2 源文件,CI 里跑一次 d2 输出 SVG 到 docs 目录,README 引 SVG。好处是图永远和文档同步,坏处是每次改图都要多一次构建。

图标库也不算全。官方 icons.d2lang.com 提供了常用图标,但跟 draw.io 内置的云厂商图标库比还差得远,画云架构图经常要自己找 URL 引进来。

语法还没到 1.0。最新是 v0.9.0,2026 年 9 月发布,从 2022 年到现在节奏一直很稳,changelog 写得细,没出现过破坏性的大改。这版还顺手把渲染性能提了一截,官方说 SVG 整体快了约十倍,真实图的中位数快约三倍,导出体积也小了两成。

还有个小变化值得知道,仓库已经从 terrastruct/d2 迁到 d2lang/d2,官网也从 terrastruct 换成了 d2lang.com,旧链接会跳转,但搜索结果里两种地址都还在。


06

VERDICT

会不会被 AI 取代

有人会问,都能让 AI 画图了,还学这个干什么。

我的看法是两边解决的不是一件事。AI 擅长从无到有,你描述一个想法,它给你一版草图,快得很。专业工具擅长从有到精,把一张图变成可版本控制、风格统一、随时能改的资产。

团队的架构图、流程图、部署图要长期维护,就还是得落在文本文件里。改一个节点,diff 里看得见,review 的时候说得清。这一点短时间看不到被替代的迹象。

更实际的分工是这样。让 AI 先出一版草图,把结构聊清楚;定稿之后转成 D2,进仓库,跟着代码一起演进。两边各干各擅长的部分。

仓库在 https://github.com/d2lang/d2

END




欢迎加入我的知识星球,全面提升技术能力。

👉 加入方式,“长按”或“扫描”下方二维码噢:

星球的内容包括:项目实战、面试招聘、源码解析、学习路线。

文章有帮助的话,在看,转发吧。

谢谢支持哟 (*^__^*)

Python社区是高质量的Python/Django开发社区
本文地址:http://www.python88.com/topic/202801