技术架构图升级别让新版本画出旧边界架构图最容易过期代码已经拆了服务图里还连着旧接口权限收紧了箭头却仍然直通。版本升级时图也要做回归。先确定图要回答什么总览图只说明组件和主数据流时序图负责请求顺序部署图再表达节点与网络。不要把所有信息堆进一张“很专业”的大图。从可验证来源更新组件名来自仓库或部署清单接口来自契约指标与权限来自配置。无法确认的关系标成待核对不凭想象补箭头。箭头写清协议或数据类型。颜色和线型有图例且含义稳定。旧组件删除后搜索所有引用。让图参与评审升级 PR 中同时核对代码、配置和对应图。读者能从图找到运行入口维护者也能从组件回到仓库位置图才不是装饰。一张好图不必塞满细节它要让人少走弯路。边界真实、层次清楚比渐变和阴影重要得多。