手把手教你用代码画架构图

1. 前言

本文将给大家介绍一种简洁明了软件架构可视化模型——C4模型，并手把手教大家如何使用代码绘制出精美的C4架构图。

阅读本文之后，读者画的架构图将会是这样的：

注：该图例仅作绘图示例使用，不确保其完整性、可行性。

2. C4模型

2.1 C4模型整体介绍

C4是软件架构可视化的一种方案。架构可视化，指的是用图例的方式，把软件架构设计准确、清晰、美观地表示出来。架构可视化不是指导开发者如何进行架构设计，而是指导开发者将架构设计表达出来，产出简洁直观的架构图。

架构可视化的方法有很多，主流的有“4+1”视图模型、C4模型。视图模型描述的是架构本身，架构确定之后，不管用什么模型去表达，本质上都应该是一样的，并没有优劣之分。

C4 模型是一种易于学习、对开发人员友好的软件架构图示方法，C4模型没有规定使用特定的图形、特定的建模语言来画图，因而使用者可以非常灵活地产出架构图。

C4模型将系统从上往下分为System Context, Containers, Components, Code四层视图，每一层都是对上一层的完善和展开，层层递进地对系统进行描述，如下图。

2.2 System Context diagram

System Context（系统上下文）视图位于顶层，是软件系统架构图的起点，表达的是系统的全貌。System Context视图重点展示的是系统边界、系统相关的用户、其他支撑系统以及与本系统的交互。本层不涉及到具体细节（例如技术选型、协议、部署方案和其他低级细节），因此System Context可以很好地向非技术人员介绍系统。

• 作用：清晰地展示待构建的系统、用户以及现有的IT基础设施。
• 范围：待描述的核心系统以及其相关用户、支撑系统，不应该出现与核心系统无关的其他系统。例如我们要描述一个打车系统，不应该把无关联的药店系统绘制进去，并且要确保一个System Context只有一个待描述的软件系统。
• 主要元素：Context内待描述的软件系统。
• 支持元素：在范围内直接与主要元素中的软件系统有关联的人员（例如用户、参与者、角色或角色）和外部依赖系统。通常，这些外部依赖系统位于我们自己的软件系统边界之外。
• 目标受众：软件开发团队内外的所有人，包括技术人员和非技术人员。
• 推荐给大多数团队：是的。

示例：

这是该网上银行系统的系统上下文图。它显示了使用它的人，以及与该系统有关系的其他软件系统。网上银行系统是将要建设的系统，银行的个人客户使用网上银行系统查看其银行账户的信息并进行支付。网上银行系统本身使用银行现有的大型机银行系统来执行此操作，并使用银行现有的电子邮件系统向客户发送电子邮件。

图例：

2.3 Container diagram

Container（容器）视图是对System Context的放大，是对System Context细节的补充。

注意这里的容器，指的不是Docker等容器中间件。Container的描述范围是一个可单独运行/可部署的单元。Container一般指的是应用以及依赖的中间件，例如服务器端 Web 应用程序、单页应用程序、桌面应用程序、移动应用程序、数据库架构、文件系统、Redis、ElasticSeach、MQ等。

Container显示了软件架构的高级形状以及系统内各容器之间的职责分工。

在Container这一层，还显示了系统的主要的技术选型以及容器间的通信和交互。

• 作用：展示系统整体的开发边界，体现高层次的技术选型，暴露系统内容器之间的分工交互。
• 范围：单个软件系统，关注的系统内部的应用构成。
• 主要元素：软件系统范围内的容器，例如Spring Boot打包后的应用，MySQL数据库、Redis、MQ等。
• 支持元素：直接使用容器的人员和外部依赖系统。
• 目标受众：软件开发团队内外的技术人员，包括软件架构师、开发人员和运营/支持人员。
• 推荐给大多数团队：是的。
• 注意：Container视图没有说明部署方案、集群、复制、故障转移等。部署相关的视图，会通过Deployment视图进行展示。

示例：

网上银行系统（此时System Contenxt中的系统已经被展开，所以用虚线框表示）由五个容器组成：服务器端 Web 应用程序、单页应用程序、移动应用程序、服务器端 API 应用程序和数据库。

• Web 应用程序是一个 Java/Spring MVC Web 应用程序，它只提供构成单页应用程序的静态内容（HTML、CSS 和 JS）。
• 单页应用程序是在客户的网络浏览器中运行的 Angular 应用程序，是网上银行功能的前端。
• 客户也可以使用跨平台 Xamarin 移动应用程序来访问网上银行。
• 单页应用程序和移动应用程序都使用 JSON+HTTPS API，该 API 由运行在服务器上的另一个 Java/Spring MVC 应用程序提供。
• API 应用程序从关系数据库中获取用户信息。
• API 应用程序还使用专有的 XML/HTTPS 接口与现有的大型机银行系统进行通信，以获取有关银行账户的信息或进行交易。
• 如果 API 应用程序需要向客户发送电子邮件，它也会使用现有的电子邮件系统。

该容器图的图例如下，主要是引入了数据库、APP、浏览器的图例。

2.4 Component diagram

将单个容器放大，则显示了该容器内部的组件。Component（组件）视图显示了一个容器是如何由许多“组件”组成的，每个组件是什么，它们的职责以及技术实现细节。

• 作用：展示了可执行的容器内部构成与分工，可直接指导开发。
• 范围：单个容器。
• 主要元素：范围内容器内的组件，通常可以是Dubbo接口、REST接口、Service、Dao等。
• 支持元素：直接连接到容器的人员和外部依赖系统。
• 目标受众：软件架构师和开发人员。
• 推荐给大多数团队：Component用于指导开发，当有需要时创建。

示例：

图例：

2.5 Code diagram

放大组件视图，则得到出组件的Code视图（代码视图）。

Code视图一般采用 UML 类图、ER图等。Code视图是一个可选的详细级别，通常可以通过 IDE 等工具按需生成。除了最重要或最复杂的组件外，不建议将这种详细程度用于其他任何内容。

在注重敏捷开发的今天，一般不建议产出Code视图。

• 范围：单个组件。
• 主要元素：范围内组件内的代码元素（例如类、接口、对象、函数、数据库表等）。
• 目标受众：软件架构师和开发人员。
• 推荐给大多数团队：不，大多数 IDE 可以按需生成这种级别的详细信息。

2.6 System Landscape diagram

C4 模型提供了单个软件系统的静态视图，不管是 System Context、Container、Component都是针对单个软件系统的进行描述的，但在实际中软件系统不会孤立存在。为描述所有这些软件系统如何在给定的企业、组织、部门等中与其他系统组合在一起，C4采用扩展视图System Landscape （系统景观图）。

系统景观图实际上只是一个没有特定关注的软件系统的系统上下文图（System Context diagram），系统景观图内的软件系统都可以采用C4进行深入分析。

• 适用范围：企业/组织/部门/等。
• 主要元素：与所选范围相关的人员和软件系统。
• 目标受众：软件开发团队内外的技术人员和非技术人员。

示例：

图例：

2.7 Dynamic diagram

Dynamic diagram（动态图）用于展示静态模型中的元素如何在运行时协作。动态图允许图表元素自由排列，并通过带有编号的箭头以指示执行顺序。

• 范围：特定功能、故事、用例等。
• 主要元素和支持元素：按照实际需要，可以是软件系统、容器或组件。
• 目标受众：软件开发团队内外的技术人员和非技术人员。

示例：

图例：

2.8 Deployment diagram

Deployment diagram（部署图）用于说明静态模型中的软件系统（或容器）的实例在给定环境（例如生产、测试、预发、开发等）中的部署方案。

C4的部署图基于UML 部署图，但为了突出显示容器和部署节点之间的映射会做略微的简化。

部署节点表示表示软件系统/容器实例运行的位置，类似于物理基础架构（例如物理服务器或设备）、虚拟化基础架构（例如 IaaS、PaaS、虚拟机）、容器化基础架构（例如 Docker 容器）、执行环境（例如数据库服务器、Java EE web/应用服务器、Microsoft IIS）等。部署节点可以嵌套，也可以将基础设施节点包括进去，例如 DNS 服务、负载平衡器、防火墙等。

可以在部署图中随意使用 Amazon Web Services、Azure 等提供的图标，只需确保被使用的任何图标都包含在图例中，不产生歧义。

• 范围：单个部署环境中的一个或多个软件系统（例如生产、暂存、开发等）。
• 主要元素：部署节点、软件系统实例和容器实例。支持元素：用于部署软件系统的基础设施节点。
• 目标受众：软件开发团队内外的技术人员；包括软件架构师、开发人员、基础架构架构师和运营/支持人员。

示例：

网上银行系统的开发环境部署图：

图例

网上银行的生产环境部署图：

图例

2.9 C4模型规范以及Review CheckList

为了确保C4模型的架构图的可读性，C4模型提供了作图规范，并且提供了CheckList供自查。

2.9.1 C4模型规范

• 图表每个图都应该有一个描述图类型和范围的标题（例如“我的软件系统的系统环境图”）。每个图表都应该有一个关键/图例来解释所使用的符号（例如形状、颜色、边框样式、线型、箭头等）。首字母缩略词和缩写词（业务/领域或技术）应为所有受众所理解，或在图表键/图例中进行解释。
• 元素应明确指定每个元素的类型（例如，人员、软件系统、容器或组件）。每个元素都应该有一个简短的描述，以提供关键职责的“一目了然”的视图。每个容器和组件都应该有明确指定的技术。
• 关系每条线都应该代表一个单向关系。每一行都应该被标记，标记与关系的方向和意图一致（例如依赖或数据流）。尝试尽可能具体地使用标签，最好避免使用“使用”等单个词。容器之间的关系（通常代表进程间通信）应该有明确标记的技术/协议。

2.9.2 Review Checklist

C4模型图表绘制完成后，可以通过Review Checklist 进行自查，检查是否有不规范之处。Review Checklist被制成网页，可以通过 https://c4model.com/review/ 进行访问。

3. C4模型架构图代码绘制实战

3.1 文本绘图工具选型

关于C4模型的架构图的绘制，一般有两种方式：

第一种是采用绘图工具，这类工具直接拖拽元素、调整样式，即可产出图片，例如draw.io、PPT等工具。绘图工具的优点是非常灵活，可以满足很多细节需求；缺点是通常调整元素的样式会比较繁琐。

第二种是采用基于文本的绘图工具，根据一定的语法去描述图片元素，最后根据文本自动渲染成图片，例如PlantUML。基于文本的绘图工具的优点是绘图快捷，只要根据语法写出描述文件，即可渲染出来，元素的样式已经默认调试好；缺点是样式不一定符合我们的审美，调整不方便。

本文着重讲解第二种，即基于文本的绘图工具。

基于文本的绘图工具有很多，例如：structurizr、PlantUML、mermaid，分别有自己的语法。

由于IntelliJ Idea、VS Code目前在开发者中非常普及，我们选择使用C4-PlantUML，结合VS Code和IntelliJ Idea分别进行C4模型的绘制。

VS Code环境的安装，见3.2。

IntelliJ Idea环境的安装，见3.3

3.2 VS Code 下C4-PlantUML安装

3.2.1 安装VS Code

直接官网下载安装即可，过程略去。

3.2.2 安装PlantUML插件

在VS Code的Extensions窗口中搜索PlantUML，安装PlantUML插件。

3.2.3 配置VS Code代码片段

安装完PlantUML之后，为了提高效率，我们最好安装PlantUML相关的代码片段。

打开VS Code菜单，层级为Code→Preferences→User Snippets，如下图：