哈喽哈喽,程序员小伙伴们👋
做架构的你,是不是也被同一个问题反复折磨?
熬夜用飞书、ProcessOn、draw.io 画完架构图,满心欢喜以为能一劳永逸;结果三个月过去,业务迭代、组件调整,架构图彻底过时,成了“无效文档”。
新同事入职,对着陈旧的 README 一脸懵,只能追着你问东问西;你一边应付咨询,一边重新画架构图,时间全浪费在重复劳动上。
架构图,永远慢业务半拍,永远在“补锅”。
今天,就给大家安利一个能从根源解决这个问题的工具——LikeC4,一款让架构“活”起来的架构建模神器,结合 AI 后更是直接封神!
👉 LikeC4 —— Architecture as Code 的进化版
先上核心链接,方便大家直接冲(收藏这篇,后续上手不迷路):
🔗 官网:likec4.dev/
🔗 GitHub:github.com/likec4/like…
开源、免费、轻量,支持 AI 联动,这三个标签就足以碾压大多数架构画图工具。
🧱 什么是 LikeC4?一句话讲明白
LikeC4 是一款开源的架构建模与可视化工具,核心理念特别简单:用 DSL 描述架构模型,用代码驱动架构图。
它基于经典的 C4 模型思想,但又打破了传统 C4 的局限,给了你足够的灵活性:
- ✅ 自定义元素类型,适配你的业务场景
- ✅ 自定义关系,精准描述组件间依赖
- ✅ 自定义样式,让架构图既规范又好看
- ✅ 自动生成多视图,不用重复画图
最关键的是:架构图不再是一张“死图片”,而是一份可版本控制、可迭代、可协作的模型代码——和你的项目代码同步更新,再也不会过时!
🚀 5 分钟上手:从零创建第一个架构模型
不用复杂配置,跟着步骤来,新手也能快速上手,全程不踩坑~
1️⃣ 第一步:安装(前置要求:Node 20+)
两种方式,任选其一,推荐第二种,更快捷:
npm install --save-dev likec4
或者直接运行,启动本地可视化服务器:
npx likec4 start
2️⃣ 第二步:编写 DSL(核心操作)
创建一个名为 model.likec4 的文件,复制下面的代码粘贴进去(注释已帮大家简化,直接用):
specification {
element actor // 定义角色元素
element system // 定义系统元素
element component // 定义组件元素
relationship async // 定义异步关系
}
model {
user = actor 'User' // 角色:用户
platform = system 'Platform' // 系统:平台
user -> platform 'uses' // 用户使用平台
}
views {
view context {
include * // 包含所有元素,生成视图
}
}
保存文件后,浏览器会自动刷新,你的第一个架构图就生成啦👇
🏗 实战示例:微服务架构建模(直接抄作业)
日常工作中,微服务架构是最常用的场景,用 LikeC4 建模超简单,看这个示例:
model {
user = actor 'User' // 用户角色
api = system 'API Gateway' // API网关系统
order = component 'Order Service' // 订单服务组件
pay = component 'Payment Service' // 支付服务组件
user -> api 'HTTP' // 用户通过HTTP访问API网关
api -> order 'REST' // API网关调用订单服务
api -> pay 'REST' // API网关调用支付服务
}
基于这一段简单的 DSL 代码,你可以自动生成 4 种视图:
- Context View(上下文视图)
- Container View(容器视图)
- Component View(组件视图)
- 自定义 View(按需配置)
从此,架构不再是“凭感觉画”,而是“可计算、可验证”的结构化模型。
📦 导出与自动化:无缝融入你的工作流
画好的架构图,支持多种格式导出,还能接入 CI/CD 自动化,彻底解放双手!
👉 导出为 PNG 图片(用于文档、PPT):
npx likec4 export png -o assets
👉 导出为 Mermaid / D2 / DOT 格式(嵌入文档、博客):
npx likec4 export mermaid
更实用的是,你可以:
- 在 CI 中自动生成架构图,代码变更后自动更新
- 部署到 GitHub Pages,打造专属架构文档站
- 嵌入到公司文档站、技术博客,保持同步更新
🤖 重磅能力:LikeC4 × AI,直接封神!
如果说“架构即代码”是 LikeC4 的基础,那 LikeC4 + AI 就是它的杀手锏,也是真正能让架构“活”起来的核心。
LikeC4 官方提供了一个专门为大模型设计的语义描述文件,直接复制就能用:
https://likec4.dev/llms-full.txt
这个文件里包含了 DSL 语法、元素说明、关系语义、示例模型等所有核心信息,相当于给大模型“喂”了一本完整的 LikeC4 使用手册。
这意味着什么?
LikeC4 不再只是“架构即代码”,而是升级为 架构即语义(Architecture as structured knowledge)。
有了这个文件,大模型可以轻松做到:
- 精准理解你的架构模型,不曲解、不遗漏
- 生成合法的 LikeC4 DSL,不用你手动写一行代码
- 修改现有架构模型,快速迭代调整
- 校验模型结构,避免语法错误
- 自动扩展视图,按需生成不同维度的架构图
🧠 LikeC4 + AI 可以怎么玩?4 个实用场景
结合 AI 后,LikeC4 的玩法直接拉满,每个场景都能帮你节省大量时间,尤其适合忙碌的架构师和工程师。
1️⃣ AI 自动生成架构模型
不用手动写 DSL,直接给大模型发指令就行。比如:
“根据 likec4.dev/llms-full.t… 这个说明,结合 redisson 官网的 javadoc(www.javadoc.io/doc/org.red… likec4 架构图 DSL 代码。”
大模型读取文件后,会直接输出可运行的 DSL 代码和对应项目结构,复制粘贴就能生成架构图👇
2️⃣ 根据代码结构自动生成架构
可以做一个自动化工具,实现“代码变更 → 架构更新 → 文档同步”的闭环:
- 读取 Spring Boot 项目模块
- 自动识别 Controller / Service / Repository
- 生成对应的 LikeC4 DSL 代码
- 自动更新模型文件,CI 中重新生成架构图
从此,架构图和代码同步迭代,再也不用手动维护!
3️⃣ 架构演进分析,一目了然
传统架构图无法跟踪变化,但 LikeC4 的 DSL 代码可以通过 git diff 查看变更:
git diff model.likec4
通过 diff 结果,你能清晰看到:
-
新增了哪些组件、删除了哪些服务
-
组件间新增或删除了哪些依赖关系
-
架构调整的具体细节,便于复盘和追溯
4️⃣ 结合 MCP / Agent,打造架构 QA Bot
LikeC4 支持 MCP 协议,这意味着 AI Agent 可以直接读取你的架构模型,实现架构问答自动化。
比如你问:“redission 有哪些关键组件?”
AI 不会瞎猜,而是直接读取架构模型中的信息,给出精准答案👇
新同事入职,直接让 QA Bot 解答架构问题,你再也不用被反复打扰~
🔥 架构的未来:可执行 + 可理解 + 可演进
其实,架构工具的演进,本质上是架构管理理念的升级,我们可以分为三个阶段:
| 阶段 | 核心特征 |
|---|---|
| 画图时代 | 架构是一张静态图片,易过时、难维护 |
| DSL 时代 | 架构是代码,可版本控制、可迭代 |
| AI 时代 | 架构是结构化语义,可自动生成、自动分析 |
而 LikeC4 正好处在 DSL 时代向 AI 时代过渡的交汇点,它不仅解决了“架构图过期”的痛点,更打开了架构自动化、智能化的大门——自动生成、自动分析、自动问答、自动演进,让你从重复的画图工作中解放出来,专注于架构设计本身。
🎯 适合谁用?对号入座
如果你属于以下人群,LikeC4 绝对值得你深入研究:
- ✅ 微服务架构团队(需要规范、可维护的架构文档)
- ✅ 做技术中台的公司(需要统一的架构建模标准)
- ✅ 想实现架构可视化自动化的工程师(对接 CI/CD,解放双手)
- ✅ 想研究 AI × 工程语义的开发者(探索架构智能化的可能性)
🏁 最后总结
很多人误以为 LikeC4 只是一个“画图工具”,但其实它的核心价值远不止于此。
LikeC4 真正的意义,是 把架构从“视觉产物”,升级为“结构化资产” —— 它让架构可版本控制、可自动化、可智能化,解决了传统架构图“过期快、维护难、协作差”的痛点。
如果你正在写技术博客、做架构治理、搞 DevOps 自动化,或者只是厌倦了反复画架构图,不妨试试 LikeC4 + AI 的组合,相信会给你带来惊喜。
最后,别忘了收藏本文,转发给身边需要的同事和朋友,一起摆脱“画图内耗”,让架构真正“活”起来~