架构图不再手画:用 LikeC4 + AI,让架构“活”起来

哈喽哈喽,程序员小伙伴们👋

做架构的你,是不是也被同一个问题反复折磨?

熬夜用飞书、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+)

两种方式,任选其一,推荐第二种,更快捷:

bash 复制代码
npm install --save-dev likec4

或者直接运行,启动本地可视化服务器:

bash 复制代码
npx likec4 start

2️⃣ 第二步:编写 DSL(核心操作)

创建一个名为 model.likec4 的文件,复制下面的代码粘贴进去(注释已帮大家简化,直接用):

c4 复制代码
specification {
  element actor  // 定义角色元素
  element system // 定义系统元素
  element component // 定义组件元素
  relationship async // 定义异步关系
}

model {
  user = actor 'User' // 角色:用户
  platform = system 'Platform' // 系统:平台

  user -> platform 'uses' // 用户使用平台
}

views {
  view context {
    include * // 包含所有元素,生成视图
  }
}

保存文件后,浏览器会自动刷新,你的第一个架构图就生成啦👇

🏗 实战示例:微服务架构建模(直接抄作业)

日常工作中,微服务架构是最常用的场景,用 LikeC4 建模超简单,看这个示例:

c4 复制代码
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):

bash 复制代码
npx likec4 export png -o assets

👉 导出为 Mermaid / D2 / DOT 格式(嵌入文档、博客):

bash 复制代码
npx likec4 export mermaid

更实用的是,你可以:

  • 在 CI 中自动生成架构图,代码变更后自动更新
  • 部署到 GitHub Pages,打造专属架构文档站
  • 嵌入到公司文档站、技术博客,保持同步更新

🤖 重磅能力:LikeC4 × AI,直接封神!

如果说"架构即代码"是 LikeC4 的基础,那 LikeC4 + AI 就是它的杀手锏,也是真正能让架构"活"起来的核心。

LikeC4 官方提供了一个专门为大模型设计的语义描述文件,直接复制就能用:

bash 复制代码
https://likec4.dev/llms-full.txt

这个文件里包含了 DSL 语法、元素说明、关系语义、示例模型等所有核心信息,相当于给大模型"喂"了一本完整的 LikeC4 使用手册。

这意味着什么?

LikeC4 不再只是"架构即代码",而是升级为 架构即语义(Architecture as structured knowledge)

有了这个文件,大模型可以轻松做到:

  1. 精准理解你的架构模型,不曲解、不遗漏
  2. 生成合法的 LikeC4 DSL,不用你手动写一行代码
  3. 修改现有架构模型,快速迭代调整
  4. 校验模型结构,避免语法错误
  5. 自动扩展视图,按需生成不同维度的架构图

🧠 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 查看变更:

bash 复制代码
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 的组合,相信会给你带来惊喜。

最后,别忘了收藏本文,转发给身边需要的同事和朋友,一起摆脱"画图内耗",让架构真正"活"起来~

相关推荐
JavaGuide2 小时前
又一款国产开源企业级文件管理系统诞生了!基于 Spring Boot 3.5.x + Sa-Token + MyBatis Flex
后端·github
大鹏19882 小时前
Go 实战 LeetCode 151:高效翻转字符串中的单词(含空格处理技巧)
后端
花果山总钻风2 小时前
SQLAlchemy各种排序示例
后端·python·中间件
Coder_Boy_2 小时前
JDK17_JDK21并发编程:资深架构常用模式+最佳实践
java·开发语言·spring boot·架构
钛态2 小时前
Flutter for OpenHarmony 实战:Stack Trace — 异步堆栈调试专家
android·flutter·ui·华为·架构·harmonyos
uzong2 小时前
管理者不要被琐事耗尽心力
后端
最贪吃的虎3 小时前
windows上如何可视化访问并远程操作linux系统上运行的浏览器或者linux可视化桌面
java·linux·运维·windows·分布式·后端·架构
钛态3 小时前
Flutter for OpenHarmony 实战:YAML — 结构化配置解析专家
flutter·ui·华为·架构·harmonyos