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

👉这是一个或许对你有用的开源项目
国产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三版本 画架构图、ER 图、部署图的人,大概都跟 PlantUML 或 Mermaid 打过交道。简单场景够用,图一复杂就开始折磨人。
D2 是另一条路。声明式图表脚本语言,你写文本,它出图,缩进表示层级,箭头表示连线。
项目两万五千多 Star,Go 写的,MPL 2.0 协议,CLI 一条命令就能装。装完不依赖任何运行时,不用为了画一张图去装 JDK,也不用起一个浏览器。
— d2lang/d2 仓库首页,Star 与许可证
我更愿意把它的赌注说清楚。老工具的验收标准是「能出图」,D2 的验收标准是「不调就好看」。三个布局引擎、一整套内置主题、精确到行的报错,全是冲着后一条去的。
「不调」这两个字不是修辞。官方那张招牌例子里,卫星图标自动排成一列、存储节点自动变成圆柱、容器自动套虚线框,这些都不是手写的样式,是渲染时按语义给的默认值。你只描述了它是什么,它自己决定长什么样。
— x 指向 y,y 指向 z
真正让它跟别的工具分开的是嵌套写法。你在文本里看到的层级,就是图里的层级。
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,不用另存本地文件。
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/
先说 PlantUML。画时序图它还行,画架构图就是在跟布局引擎打架。你定义了 A 包含 B,B 连到 C,出来的图里 B 跑到 A 外面去了,C 被挤到画布右下角。想调,就得往代码里塞 skinparam、ortho 和各种方向参数,调完还不一定对。
Mermaid 的痛点不一样。GitHub 原生渲染它,这是它最大的护城河,README 里贴一段代码就自动出图。但节点一多,布局基本失控,而且你没有任何办法把某个节点挪到想要的位置。
flowchart TD
subgraph 订单
A[下单] --> B[扣库存]
end
subgraph 支付
C[收款]
end
B --> C
换成 D2,层级直接由缩进决定,subgraph 这个词根本不用出现。
订单: {
下单 -> 扣库存
}
支付: {
收款
}
订单.扣库存 -> 支付.收款
还有一个被忽略的问题,错误提示。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/
自动布局是文本绘图的核心。语法再顺手,布局烂就是废物。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 的体验更接近写代码,而不是在跟一个黑盒较劲。
插件是它落地最快的地方。官方给了 VSCode、Vim、Obsidian 三个,社区把 Confluence、Maven、Pandoc、MkDocs、VitePress、Zed 这些都补齐了。写文档时直接嵌 d2 代码块,预览跟着变。
对团队来说,Confluence 和 Maven 那两个最实用。前者让 wiki 里的架构图能跟着版本走,后者在打包阶段就把图生成好,不用谁记着手动更新。
它还能当 Go 库用。CI 里跑完测试顺手生成一张架构现状图,或者扫一遍数据库 schema 自动出 ER 图,这类批量化场景是原生支持的,不用绕命令行。
import (
"github.com/d2lang/d2/d2compiler"
"github.com/d2lang/d2/d2renderers/d2svg"
)
注意包路径跟着仓库一起搬了。老教程里写的 oss.terrastruct.com/d2 已经是过去式,现在模块路径是 github.com/d2lang/d2。
动画是它的独门。定义一个文件的多个 step,导出的是带过渡效果的 SVG,一张图讲完架构怎么演进。做技术分享的时候,不用再画三张图,也不用在 PPT 里做动画。
steps: ["0", "1", "2"]
甲 -> 乙 { style.animated: true }
导出现在覆盖 SVG、PNG、GIF、PDF 和 PPTX,都是内置渲染器在做,不依赖外部工具链。
用它的项目也不缺。ElasticSearch、Sourcegraph、Temporal、Tauri、IntelliJ 的仓库里都有 .d2 文件,这比任何宣传都好使。
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,旧链接会跳转,但搜索结果里两种地址都还在。
我的看法是两边解决的不是一件事。AI 擅长从无到有,你描述一个想法,它给你一版草图,快得很。专业工具擅长从有到精,把一张图变成可版本控制、风格统一、随时能改的资产。
团队的架构图、流程图、部署图要长期维护,就还是得落在文本文件里。改一个节点,diff 里看得见,review 的时候说得清。这一点短时间看不到被替代的迹象。
更实际的分工是这样。让 AI 先出一版草图,把结构聊清楚;定稿之后转成 D2,进仓库,跟着代码一起演进。两边各干各擅长的部分。
仓库在 https://github.com/d2lang/d2
欢迎加入我的知识星球,全面提升技术能力。
👉 加入方式,“长按”或“扫描”下方二维码噢:

星球的内容包括:项目实战、面试招聘、源码解析、学习路线。
文章有帮助的话,在看,转发吧。
谢谢支持哟 (*^__^*)