详细说明
优势 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/
访问官网 ↗
推荐文章
- 01 GitLab CI/CD 最佳实践:从入门到生产级流水线 07-18
- 02 Prometheus 监控系统搭建:从指标采集到告警通知 07-18
- 03 Ansible 自动化运维实战:从配置管理到应用部署 07-18
- 04 Docker 入门教程:从安装到容器化部署 Web 应用 07-18
- 05 GitHub Actions CI/CD 配置教程:自动化构建、测试与部署 07-18
- 06 API 集成入门:REST vs GraphQL 对比与选型指南 07-18
- 07 Docker Compose 多容器部署:构建完整的应用编排方案 07-18
- 08 Kubernetes 入门部署指南:从零搭建 K8s 集群 07-18
- 09 VS Code 插件推荐 2026:提升开发效率的必备扩展 07-18
- 10 3D Secure 2 认证实操:流程、豁免与责任转移 11-09