2025 年开源软件架构图生成工具指南

3. Mermaid：文本驱动的图表生成器

使用方法：

• 在线编辑器：https://mermaid.live，直接输入代码生成图表
• Markdown 集成：在支持 Mermaid 的编辑器（如 VS Code、Typora）中使用```mermaid 代码块
• API 服务：集成 Kroki 等服务实现后端渲染

核心语法（C4 架构图示例）：

C4Context title 在线书店系统
Person(customer, "顾客", "浏览和购买图书")
System_Boundary(system, "在线书店系统") {
    Container(frontend, "前端", "React+Vite", "用户界面")
    Container(backend, "后端", "Spring Boot", "业务逻辑")
    ContainerDb(database, "数据库", "PostgreSQL", "存储数据")
}
Rel(customer, frontend, "访问", "HTTPS")
Rel(frontend, backend, "调用", "REST API")
Rel(backend, database, "读写", "JDBC")

支持图表类型：

• 流程图（Flowchart）：最常用，描述业务流程和逻辑
• 时序图（Sequence Diagram）：显示交互顺序，适合 API 流程
• 类图（Class Diagram）：UML 标准，展示系统结构
• C4 架构图：Simon Brown 的 C4 模型，系统架构可视化标准
• 甘特图、饼图等 20+ 种专业图表

使用场景：

• 技术文档（README、Wiki）：文档即图表，版本可控
• API 设计：用代码描述接口流程，直观展示
• 敏捷开发：用户故事和任务流程可视化

入门步骤：

1. 打开 Mermaid Live Editor
2. 在左侧输入代码，右侧实时预览
3. 调整代码，优化布局
4. 导出为 PNG/SVG 或复制代码到 Markdown 文档

4. PlantUML：专业 UML 图表生成器

安装方式：

• Java 版：下载 JAR 包，命令行运行：java -jar plantuml.jar your_file.puml
• IDE 插件：VS Code、IntelliJ IDEA、Eclipse 等均有插件，保存即生成图像
• 在线版：通过 PlantUML 网站或 Kroki 服务

核心优势：

• UML 全覆盖：类图、时序图、用例图、活动图等所有 UML 类型
• 文本驱动：代码即图表，版本控制友好
• 批量生成：一次编写，自动生成多张关联图表
• 集成能力：与 CI/CD 流水线集成，代码变更自动更新图表

语法示例（类图）：

@startuml
class Customer {
    -id: Long
    -name: String
    +getOrders(): List<Order>
}
class Order {
    -id: Long
    -total: Double
    +calculateTax(): Double
}
Customer "1" --> "*" Order : 下订单
@enduml

使用场景：

• 软件设计阶段：系统建模和架构设计
• 教育领域：UML 教学和课件制作
• 大型项目文档：完整的系统设计文档生成

实用技巧：

• 安装 Graphviz（开源布局引擎）获得更优的自动布局效果
• 使用 skinparam 自定义图表样式，如颜色、字体
• 在 Markdown 中使用 PlantUML 代码块，文档与图表同步更新

5. Structurizr DSL：C4 模型标准实现

安装与使用：

• 命令行：下载 structurizr-cli，通过 DSL 文件生成图表
• IDE 插件：VS Code 插件支持语法高亮和验证
• 云服务：Structurizr 网站提供免费个人版和付费团队版

核心优势：

• C4 模型原生支持：Simon Brown（C4 模型创始人）官方推荐工具
• 层次化建模：完整支持 Context/Container/Component/Code 四级抽象
• 自动布局：生成专业美观的架构图，无需手动调整
• 文档生成：不仅生成图表，还能输出完整架构文档

DSL 语法示例（系统上下文）：

workspace OnlineBookstore {
    model {
        person(customer, "顾客", "浏览和购买图书")
        softwareSystem(bookstore, "在线书店系统", "提供图书浏览和购买功能")
        relationship(customer, bookstore, "浏览/购买图书", "HTTPS")
    }
    views {
        systemContext(bookstore, "系统上下文图", "在线书店与外部用户的交互") {
            include customer
            include bookstore
        }
    }
}

使用场景：

• 企业级架构设计：大型系统的标准 C4 建模
• 架构评审：为技术委员会提供标准化的架构视图
• 文档驱动开发：生成符合 C4 标准的架构文档和图表

入门建议：

1. 学习 C4 模型基本概念（Context、Container、Component、Code）
2. 从简单的系统上下文图开始，逐步构建完整模型
3. 使用 VS Code 插件获得更好的开发体验

6. Diagrams (Python)：云原生架构代码生成器

安装：

pip install diagrams

核心优势：

• 云服务全覆盖：AWS(2000+ 图标)、Azure、GCP、K8s、阿里云等主流云平台
• 代码即图表：用 Python 代码描述架构，版本控制友好
• 高度定制：可自由组合云服务组件，创建复杂的多层架构
• 自动化：与 CI/CD 集成，代码变更自动更新架构图

代码示例（AWS 三层架构）：

from diagrams import Diagram
from diagrams.aws.compute import EC2
from diagrams.aws.database import RDS
from diagrams.aws.network import ELB

with Diagram("Web Service with DB", show=False):
    elb = ELB("lb")
    web = [EC2("web1"), EC2("web2"), EC2("web3")]
    db = RDS("db")
    elb >> web >> db

使用场景：

• 云原生架构设计：AWS/Azure/GCP 等云环境的架构可视化
• DevOps 流程：基础设施即代码 (IaC) 的配套文档
• 微服务架构：展示服务间的依赖关系和数据流

进阶用法：

• 使用 Cluster 分组相关组件，使图表更清晰
• 自定义节点样式（颜色、大小），突出关键组件
• 与 Mermaid 或 PlantUML 结合，在文档中同时展示高层和细节架构

7. Go-Diagrams：Golang 开发者的架构图工具

安装：

go get -u github.com/blushft/go-diagrams

核心优势：

• Go 语言原生支持，与 Go 项目无缝集成
• 丰富的云服务图标库，支持 AWS、Azure、GCP、K8s 等
• 无需外部依赖，二进制文件独立运行

代码示例：

package main

import (
	"github.com/blushft/go-diagrams/diagram"
	"github.com/blushft/go-diagrams/targets/aws/compute"
	"github.com/blushft/go-diagrams/targets/aws/network"
)

func main() {
	diag := diagram.New("Go Web Service", diagram.Portrait)
	diag.NodeSpace(200, 100)
	lb := diag.Node("LB", network.LoadBalancer())
	web := diag.Nodes("Web", 3, compute.EC2Instance())
	db := diag.Node("DB", compute.Database())
	lb.Connect(web...)
	for _, w := range web {
		w.Connect(db)
	}
	diag.SavePNG("architecture.png")
}

使用场景：

• Go 语言项目架构设计和文档
• DevOps 和云原生架构可视化
• 与 Go 微服务项目集成，自动生成架构文档

8. Kroki：一站式文本图表服务

安装方式：

• Docker 部署：docker run -p 8000:8000 yuzutech/kroki
• 源码安装：GitHub 下载源码，按文档构建运行
• 在线服务：公共实例（https://kroki.io）可直接使用

支持的图表语言：

• Mermaid、PlantUML、C4-PlantUML、Excalidraw、D2 等 20+ 种

核心优势：

• 统一接口：一个 API 支持多种图表语言，集成简便
• 自托管：私有部署，数据不外流，适合企业环境
• 文档集成：与 Confluence、Wiki.js、Hugo 等文档系统无缝集成

使用示例：

# 通过 URL 直接生成 Mermaid 图表
https://kroki.io/mermaid/svg/eNpLzE7z0yU1zSszS1JzCvRUAJ9CjA

使用场景：

• 企业文档平台：内部 Wiki、知识库集成图表服务
• 技术博客：Hugo、Jekyll 等静态网站生成图表
• 私有云环境：与内部系统集成，提供统一的图表服务

9. IcePanel（开源版）：专业 C4 模型协作工具

使用方式：

• 开源版：GitHub 获取源码，自行部署（仅核心功能开源）
• 云服务：官方提供付费云服务（功能更完整）

核心优势：

• C4 模型优化：专为 C4 架构图设计的界面和操作体验
• 团队协作：实时多人编辑，评论和标注功能
• 美观输出：自动生成高质量的 C4 架构图，无需手动调整

使用场景：

• 专业架构团队：大型系统的 C4 模型设计和评审
• 企业架构治理：标准化的架构视图管理
• 架构培训：C4 模型教学和实践

10. C4-PlantUML：PlantUML 的 C4 模型扩展

使用方法：

• 在 PlantUML 基础上添加 C4 专用语法
• 使用 IDE 插件（如 VS Code 的 PlantUML 插件）支持

语法示例：

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
C4_Context(
    System("Software System", "提供软件系统功能"),
    Person("User", "使用软件系统的用户")
)
@enduml

核心优势：

• 融合优势：结合 PlantUML 的强大 UML 支持和 C4 模型的架构描述能力
• 学习成本低：对熟悉 PlantUML 的用户几乎无额外学习成本
• 生态兼容：与 PlantUML 生态工具完全兼容

使用场景：

• 从传统 UML 向 C4 模型过渡的团队
• 需要同时描述详细 UML 和高层 C4 架构的项目

工具对比与选择指南

2025 年推荐组合方案

1. 个人/小团队日常使用：
   • 入门级：diagrams.net 桌面版（离线 + 丰富模板）
   • 进阶版：Mermaid + VS Code（文档即图表，版本控制）
2. 技术文档与 Markdown：
   • 轻量级：Mermaid（语法简单，GitHub 原生支持）
   • 专业级：PlantUML + C4-PlantUML（UML+C4 双支持）
3. 云原生架构设计：
   • Python/Go 项目：Python Diagrams 或 Go-Diagrams（云服务图标最全）
   • 标准 C4：Structurizr DSL（官方推荐）
4. 团队协作与评审：
   • 实时协作：Excalidraw（手绘风格，团队脑暴）或 IcePanel（C4 专用）
   • 文档协作：Kroki 自托管服务 + Confluence（统一图表服务）
5. 企业级架构治理：
   • 标准化：Structurizr DSL + GitHub Actions（自动生成，持续集成）
   • 一站式：Kroki + 私有文档平台（所有图表需求统一解决）

C4 模型快速入门：架构图标准

C4 模型是 Simon Brown 提出的软件架构可视化标准，由四个层次组成：

1. Component（组件）：容器内部的模块和功能单元
2. Code（代码）：具体实现细节，类和接口
3. Container（容器）：系统内部主要组件（如 Web 服务、数据库）
4. Context（上下文）：系统与外部参与者的关系

Container 示例：

C4Container
Container(web, "Web 服务", "Spring Boot", "处理 HTTP 请求")
ContainerDb(db, "数据库", "PostgreSQL", "存储数据")
Rel(web, db, "读写", "JDBC")

Context 示例：

C4Context
Person(user, "用户", "使用系统")
System(system, "系统名称", "系统功能")
Rel(user, system, "交互方式", "协议/技术")

实践建议：从 Context 图开始，逐步细化到 Container 和 Component，为每个架构决策提供清晰视图

总结

架构图是团队沟通和系统设计的重要工具，选择合适的工具能大幅提升效率。根据 2025 年最新趋势，推荐：

• 新手入门：diagrams.net（全能型，零学习成本）
• 文档集成：Mermaid（Markdown 友好，Git 兼容）
• 云原生项目：Python Diagrams（Python 生态首选）
• 企业级架构：Structurizr 或 C4-PlantUML（C4 标准支持）
• 团队协作：Excalidraw（实时多人编辑）

参考资料：各工具官网文档、GitHub 仓库及开发者调查报告