技术架构图升级：别让新版本画出旧边界

技术架构图升级：别让新版本画出旧边界

架构图最容易过期：代码已经拆了服务，图里还连着旧接口；权限收紧了，箭头却仍然直通。版本升级时，图也要做回归。

先确定图要回答什么

总览图只说明组件和主数据流，时序图负责请求顺序，部署图再表达节点与网络。不要把所有信息堆进一张“很专业”的大图。

从可验证来源更新

组件名来自仓库或部署清单，接口来自契约，指标与权限来自配置。无法确认的关系标成待核对，不凭想象补箭头。

• 箭头写清协议或数据类型。
• 颜色和线型有图例且含义稳定。
• 旧组件删除后搜索所有引用。

让图参与评审

升级 PR 中同时核对代码、配置和对应图。读者能从图找到运行入口，维护者也能从组件回到仓库位置，图才不是装饰。

一张好图不必塞满细节，它要让人少走弯路。边界真实、层次清楚，比渐变和阴影重要得多。