1. 架构图的价值与常见误区
架构图是技术人员日常工作中最基础也最重要的沟通工具。从业十年,我见过太多"灾难级"的架构图:有的像蜘蛛网一样复杂,有的过于简化到毫无信息量,还有的用各种花哨图形堆砌却不知所云。这些图不仅无法传递设计思想,反而会让团队陷入无休止的讨论和误解。
最常见的三大误区:
- 过度设计:为了展示技术实力,把所有的中间件、组件都塞进图中,导致核心链路被淹没
- 缺乏层次:将基础设施、服务架构、数据流等不同维度的内容混在同一张图里
- 符号混乱:随意使用图形符号(比如用数据库图标表示API),缺乏统一图例说明
提示:好的架构图应该像城市地铁图——清晰展示关键节点和连接路线,而不是精确到每栋建筑物的施工图纸。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 架构图分类与适用场景
2.1 系统上下文图(Context Diagram)
适用于向非技术人员(如产品经理、业务方)说明系统边界。建议:
- 用单个方块表示目标系统
- 外围标注与之交互的外部系统/角色
- 箭头标明数据流向(进/出系统)
- 避免出现技术组件细节
2.2 组件关系图(Component Diagram)
开发团队最常用的架构图类型,要点包括:
- 按功能模块划分组件(如订单服务、支付服务)
- 用不同颜色区分自研/第三方服务
- 明确标注通信协议(HTTP/gRPC/消息队列)
- 对关键数据存储做特殊标记
2.3 部署架构图(Deployment Diagram)
运维视角的基础设施视图,需要体现:
- 物理/逻辑分组(可用区、集群划分)
- 资源规格(CPU/内存配置)
- 网络拓扑(VPC、子网、安全组)
- 高可用设计(主从、多活部署)
3. 绘图工具与实用技巧
3.1 工具选型建议
- Draw.io(现diagrams.net):免费、跨平台、支持中文,组件库丰富
- Lucidchart:团队协作功能强大,支持版本对比
- Excalidraw:手绘风格,适合快速草图设计
- Visio:企业级场景常用,但学习成本较高
避坑指南:避免使用PPT画架构图——调整排版耗时且难以维护版本。
3.2 图形使用规范
- 服务/应用:统一用矩形或圆柱体表示
- **数据库
