mingrammer/diagrams

这是什么？

核心功能

• 01用 Python 代码定义架构图，可随 git 进行版本管理。
• 02内置 AWS、Azure、GCP、Kubernetes、阿里云、Oracle Cloud 等图标集。
• 03支持本地部署、SaaS、编程语言框架和 C4 模型等节点类型。
• 04使用 Graphviz 渲染输出图像。
• 05提供可在浏览器中直接运行的在线 Playground。

适用场景

• 在实施前快速原型设计新的云系统架构。
• 为现有云或 Kubernetes 部署绘制图表，并与代码一同维护。
• 在文档流程中自动生成架构图。

快速上手

1. 1

   安装 Graphviz（macOS 可通过 Homebrew）

   brew install graphviz
2. 2

   使用 pip 安装 diagrams 包

   pip install diagrams

使用前须知

• !渲染图表前需要单独安装 Graphviz。
• !需要 Python 3.9 或更高版本。
• !它不控制任何云资源，也不生成 Terraform 或 CloudFormation 代码，仅用于绘制图表。

标签

常见问题

diagrams 是什么？

用 Python 代码绘制云和系统架构图，内置 AWS、Azure、GCP、Kubernetes 等服务图标。 Diagrams 是一个用 Python 代码绘制云架构和系统架构图的库。无需拖拽图形工具，只需在脚本中描述节点及其连接关系，即可通过 Graphviz 渲染出图。由于图表本身就是代码，可以和基础设施代码一起纳入版本控制并随之更新。

diagrams 可以免费使用吗？用的什么许可证？

diagrams 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

diagrams 还在维护吗？

活跃维护中。diagrams 最近一次提交是在 2026年10月17日。

diagrams 适合用来做什么？

在实施前快速原型设计新的云系统架构。 为现有云或 Kubernetes 部署绘制图表，并与代码一同维护。 在文档流程中自动生成架构图。

diagrams 怎么安装和运行？

安装 Graphviz（macOS 可通过 Homebrew）: brew install graphviz 使用 pip 安装 diagrams 包: pip install diagrams

在哪里获取 diagrams？

源代码和安装说明在 GitHub 上：https://github.com/mingrammer/diagrams