架构图别只画方框把数据、判断和失败出口标出来一张“服务 A 指向服务 B”的图通常解释不了系统怎么工作。好的架构图要让读者看到数据从哪里来、谁做判断、失败后去哪。先选图的任务部署图回答进程和网络边界时序图回答调用顺序数据流图回答转换与存储。不要把三种信息全塞进一张海报。节点名称尽量使用代码和配置里的真实概念箭头标协议或数据类型。异步步骤画出队列、回调和取消重试标明由哪一层负责降级说明返回什么而不是写一个“Fallback”框就结束。用实现校对图从一个请求标识出发对照路由、日志和 Trace 走完整条链。若图上的组件在运行记录中找不到或代码多出隐含依赖就更新其中一边。架构图是判断工具不是装饰物保持可追溯比画得热闹更重要。