C4模型入门，你准备好了吗？

说实话，C4模型是个好东西，哈哈，它Neng帮咱把软件架构描述得清清楚楚。

你上次打开团队的架构图是什么时候？

大多数团队dou有架构图，可是你懂的，没人信它们。

Confluence 上躺着一张两年前画的系统拓扑图，Visio 文件在某个共享盘里PowerPoint 里有几页"技术方案评审"的框线图。

问题是：没人信它们。

C4模型由 Simon Brown 提出，是一种轻量级、可 的软件架构表达方法。

通过四个层次的抽象逐步揭示系统结构，你Ke以轻松地理解系统的边界在哪里。

害，咱就是说这玩意儿挺好用的。

这个问题啊，你得检查检查你的内容质量，还有关键词优化是不是Zuo得不够好。

不对不对，应该是检查是不是原创内容不够，或者链接建设有问题。

C4 是 Context、Container、Component、Code 的缩写，代表四层从粗到细的视图。

系统上下文图回答一个问题：这个系统是什么谁在用它，它和哪些外部系统交互？

C4Context title 电商系统 - 系统上下文图 Person ... 容器图

容器在 C4 模型中有特定含义：一个可独立运行的进程或可部署单元。

C4Container title 电商系统 - 容器图 Person System_Boundary { Container ... 组件图与代码

C4Component title 订单服务 - 组件图 Container_Boundary { Component ... C4模型的实践与工具

Mermaid 从 v9. 开始支持 C4 图语法，不需要额外安装工具，直接在 GitHub 仓库里渲染，hen方便。

C4 不是唯一的架构描述方法，但它的简洁性大幅降低了实际采用的门槛。

C4Dynamic title 下单流程 - 动态视图 ContainerDb ... . C4 的部署图展示容器如何映射到基础设施。 运维人员和 SRE 的日常工作中特别有用。 它回答的问题包括：每个服务部署了几个实例？数据库是单机还是主从？流量入口在哪里？ 常见的错误包括试图在一张图上展示所有信息。 C4 模型的核心原则就是分层。 Ru果一张图上的元素超过 个，考虑把它拆分到下一层。 Level 组件图的维护成本不低。 对于简单的 CRUD 服务，Level 容器图Yi经提供了足够的信息。 只有核心服务、复杂服务、或者新人难以理解的服务，才需要 Level . 判断标准hen简单：Ru果一个服务的内部结构，一个新工程师kan代码目录就Neng理解，那不需要 Level . Ru果服务内部有复杂的事件驱动逻辑、多个状态机、或者非直觉的模块依赖，才值得画 Level . 比起一次性画完所有图然后逐渐过期，geng好的策略是：先画 Level 和 Level ，然后随着需求逐步补充。 有新人入职、有技术评审、有事故复盘——这些dou是补充和geng新架构图的好时机。 这是初学者Zui常犯的错误。C4 模型中的 Container 是"可独立运行的进程或可部署单元"，和 Docker 容器是完全不同的概念。一个 C4 Container Ke以是一个 Java JAR、一个 Node.js 进程、一个数据库实例，也Ke以是一个部署在 Docker 容器中的微服务——但它和 Docker 没有绑定关系。Simon Brown 自己也承认这个命名造成了混淆，但因为 C4 模型在 Docker 流行之前就Yi经定名，改名的成本太高。 架构文档的核心矛盾是：人人dou知道它重要，但大多数团队Zuo不好。 Zuo不好的原因不是态度问题，而是方法和工具的问题——没有分层、没有语义、没有工程化手段。 C4 模型提供了一个实用的分层框架：Level 对齐系统边界，Level 展示部署结构，Level . 深入容器内部，Level . 交给 IDE 自动生成。diagram-as-code. 工具让图Ke以被版本管理、diff、review。ADR 记录了"为什么"。三者组合起来架构文档就Neng活下来。 但工具不是万Neng的。架构文档Zui终Neng不Neng维护下去，取决于团队是否把"geng新文档"视为开发流程的一部分，而不是额外负担。Zui好的Zuo法是把架构图的geng新嵌入到Yi有的工程流程中——代码 review 时顺便kan一下图是否需要geng新， Sprint 回顾时检查一下 ADR 是否有遗漏。 架构文档不需要完美，但它需要活着。