PROVIDER - 声明式图表语言

D2

D2 是声明式图表语言,1 个 .d2 文件即可产出架构图,内置自动布局可减少 90% 手动排版,支持 5 种以上导出格式与 Watch 模式,MPL-2.0 开源单二进制安装;不足是生态偏小、高级布局调优需学习引擎配置。

开发工具 美国 2026.11.19
4.1分

详细说明

优势 5 项

用声明式语法描述图表,1 个 .d2 文件即可产出完整架构图
内置自动布局引擎,可减少 90% 的手动排版工作
支持 5 种以上导出格式,包括 SVG、PNG 与 PDF
提供 Watch 模式,保存文件后 1 秒内自动重新渲染
以 MPL-2.0 开源,CLI 为单二进制,安装后即可使用

不足 4 项

图表类型与生态相比 Mermaid 仍然偏少
高级布局调优需要理解 dagre 与 ELK 配置
中文社区资料较少,遇到问题排查成本高
主题与字体需要额外配置才能达到理想效果

服务商概述

D2 是 Terrastruct 推出的声明式图表语言,把架构图的绘制重心从拖拽排版转移到结构化描述上。

在开发工具分类里,它属于「图表即代码」的新一代实现:语法可读性高,自动布局减少了大量手工微调。

核心优势

  • 声明式语法:描述关系而非坐标
  • 自动布局:减少 90% 手工排版
  • 导出格式多:5 种以上可选
  • Watch 模式:保存即刷新
  • 单二进制:安装与分发简单

产品生态

平台能力

容器与层级建模、自动布局、图标与字体配置、主题切换、Watch 实时渲染、Markdown 嵌入与 CLI 批量导出。

集成

可与 VS Code 插件、Obsidian 插件、GitHub Actions 与文档站构建流程结合。

典型场景

系统架构图维护、云资源拓扑描述、数据流示意、技术方案评审配图。

不足之处

  • 生态规模:图表类型少于 Mermaid
  • 调优门槛:布局引擎配置需学习
  • 资料数量:中文内容较少
  • 样式定制:主题与字体需额外配置

适用场景

  • 架构图长期维护(★★★★★):声明式便于演进
  • 自动布局需求强(★★★★☆):省去手工对齐
  • 多格式交付(★★★★☆):导出方式灵活
  • 快速轻量出图(★★★☆☆):Mermaid 上手更快

价格参考

项目 价格 备注
D2 CLI $0 MPL-2.0 开源免费
D2 Studio 按用户订阅 可视化编辑与协作
自建使用 $0 单二进制或容器镜像

常见问题

D2 与 Mermaid 的区别?

D2 的自动布局与容器建模更强,Mermaid 的平台原生支持更广。

需要联网吗?

不需要,CLI 完全离线渲染。

支持导出 PDF 吗?

支持,可输出 SVG、PNG 与 PDF 等格式。

能嵌入文档站吗?

可以,通过插件或预先渲染为 SVG 再嵌入。

代码示例

# diagram.d2
direction: right

user: User {
  shape: person
}

api: API Gateway
db: PostgreSQL {
  shape: cylinder
}

user -> api: HTTPS
api -> db: SQL
api -> cache: GET/SET
cache: Redis {
  shape: cylinder
}
# 安装并渲染
curl -fsSL https://d2lang.com/install.sh | sh -s --
d2 diagram.d2 diagram.svg

# 进入 Watch 模式,保存即刷新
d2 --watch diagram.d2 diagram.svg

社区与资源

  • 官方网站:https://d2lang.com/
  • 源码仓库:https://github.com/terrastruct/d2
  • 语法参考:https://d2lang.com/tour/intro
前往 D2 官网 → https://d2lang.com/
访问官网 ↗