技术架构图评审箭头比方框更值得看方框写得越多图不一定越清楚。架构图真正有用的部分是数据从哪里来、以什么身份流动、失败后停在哪里。箭头没有语义方框再精致也只是组件合影。一张图只回答一个问题部署图说明进程与资源时序图说明调用顺序数据流图说明读写与边界。不要把三种视角压在同一页。标题直接写读者要判断的事情例如“检索失败如何回退”。箭头补齐协议和状态标明同步或异步、请求或事件、是否跨信任域。关键节点写出超时、重试和幂等不用把每个配置字段搬上图。若某条线只存在于设想明确标成待验证。用代码和日志反证随机挑一条正常路径和一条失败路径对照接口、配置与追踪记录。图里没有的调用要补实际不存在的组件要删。评审的是事实一致性不是配色水平。好图能帮人定位下一步去哪里看。做到这一点留白比再添一个云朵图标更有价值。