你是否还在为画完一张C4架构图后,它迅速过时而苦恼?是否厌倦了在PPT、Draw.io或Miro里反复手动修改系统边界、组件关系,却始终跟不上代码的实际演进?LikeC4正是为此而生——它不是又一个绘图工具,而是一套“架构即代码”(Architecture-as-Code)的全新实践:用简洁文本定义架构,自动同步生成精准、可交互、实时反映代码现状的可视化图表。从此,架构图不再是静态快照,而是与代码共生共长的“活文档”。
核心功能
- 文本即架构:使用类DSL的轻量语法(如
system "Payment Service" { ... })声明式描述系统、容器、组件及关系,告别鼠标拖拽和像素对齐 - 图表实时联动代码:通过插件自动扫描源码(支持TypeScript/JavaScript/Java等),将类、接口、包结构映射为架构元素,确保图表永远与最新代码一致
- 灵活可扩展的建模体系:不止于标准C4四层模型——可自定义任意层级(如Domain Layer、Infra Layer)、新增元素类型(如“Legacy Gateway”“Feature Flag”)和专属图标/配色
- 开箱即用的多端体验:VS Code插件提供语法高亮、智能补全、一键预览;在线Playground零配置试用;CLI工具支持CI/CD中自动校验与生成静态HTML/PNG
- 协作友好型架构文档:生成的图表自带可点击跳转(如点击组件直达GitHub源码行)、版本对比、评论注释区,支持团队在图上直接讨论设计决策
- 无缝集成现有工作流:支持导出PlantUML、Mermaid兼容格式;可嵌入Confluence、Notion或Git仓库README;与Jira、GitHub Issues双向关联变更上下文
适合哪些人用
如果你是以下角色之一,LikeC4将显著提升你的架构效率:技术负责人——快速对齐跨团队系统全景,避免“架构黑盒”;软件架构师——聚焦设计本质而非绘图技巧,用代码逻辑驱动架构演进;资深开发工程师——在写PR时同步更新架构视图,让新成员3分钟看懂模块职责;DevOps/SRE工程师——将部署拓扑、服务依赖自动纳入架构图,打通开发与运维视角;技术文档工程师——告别手动画图+截图+上传的繁琐流程,一份文本生成全平台文档。
快速上手
三步开启你的活架构之旅:
① 安装VS Code插件:在扩展市场搜索“LikeC4”,一键安装(已获超10万次下载);
② 新建arch.c4文件,粘贴示例(官网提供电商、微服务等模板);
③ 右键选择“Preview LikeC4 Diagram”,即时生成可交互图表——修改文本,图表秒级刷新!进阶用户可通过npx likec4 generate命令行批量导出多格式交付物。
项目信息
likec4/likec4
GitHub
Visualize, collaborate, and evolve the software architecture with always actual and live diagrams from your code
4.2k
今日 +172 stars today
Stars
295
Forks
TypeScript
MIT
TypeScript | GitHub 项目地址 | MIT开源协议 | 当前 Star 数:4160
架构不该是孤岛里的PPT,而应是流淌在代码血液中的共识——LikeC4,让每一次提交都成为架构演进的自然刻度。


