D2 的价值不是画图更快，而是让架构图变成可维护的代码资产

D2 这类声明式画图工具的价值，不在于“比 draw.io 更酷”，而在于它把架构图从一次性图片变成了可维护的工程资产。对程序员来说，图最痛苦的不是第一次画，而是需求变了、接口变了、系统拆了之后，没人愿意再维护。

图表为什么需要工程化

架构图、流程图、依赖图本质上是系统知识的一部分。如果它只存在于截图、PPT 或拖拽画布里，就很难 code review、难 diff、难自动生成、难和文档一起演进。D2 用文本描述节点和关系，让图可以进入 Git、CI、文档站和 AI 工作流。

D2 适合解决什么

• 架构图：服务、数据库、队列、网关、外部依赖。
• 流程图：审批、支付、工单、故障响应链路。
• 技术文档配图：和 Markdown、Wiki、代码仓库一起维护。
• 设计评审：用 diff 看结构变化，而不是对比两张图片。
• AI 辅助制图：让模型生成文本图表，再由人 review。

和传统画图工具不是替代关系

拖拽工具适合视觉微调和非技术用户协作，D2 更适合程序员维护结构性图表。它强在版本化、自动化、复用和可读性；如果目标是像素级视觉海报，传统设计工具仍然更合适。

落地建议

1. 把核心架构图放进仓库，而不是散落在个人网盘。
2. 为图表建立命名、目录和主题规范。
3. 在文档构建或 CI 中自动渲染 SVG/PNG。
4. 让 PR 同时审代码和图表变化。
5. 用 AI 生成初稿，但必须由工程师检查关系是否准确。

D2 代表的是一个更大的趋势：技术文档正在从“写完就过期”变成“和代码一起演进”。图表也应该进入这个体系。