知识卡片
架构维护易偏离
没有文档良好、维护良好的架构,实现就会不可避免地偏离设计。工具可反向提取实际架构来检查偏离,但依然困难:许多系统本无架构文档,开发人员习惯直接读源码,文档也常未随变化同步。更深的困境是层、子系统等概念只存在于人的脑海中,代码中没有直接载体;靠命名约定暗示结构并不彻底,因为命名与实际结构可能逐渐脱节。另见[[架构与团队同构]]。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- · 查看原书依据
即使存在描述软件架构的文档,但是在软件开发的过程中没有对软件的变化进行文档记录,导致文档和实际架构不同步。
参考来源
- 位置:《软件架构理论与实践》第7章《架构驱动的软件开发》"7.4.2 架构的维护"节(源文件:_epub-src/OEBPS/text00059.html)
- 结论依据:原文说明"只是拥有一个软件架构与拥有一个具有良好文档、良好组织结构和良好维护性的架构是完全不一样的。如果没有这些,架构将不可避免地偏离原来的方向",并列出架构提取技术不简单的三个原因,直接支撑本卡片结论。
- 原始内容:许多软件系统没有对架构进行有效的文档化描述。……开发人员往往都是通过源代码进行架构的描述。……即使存在描述软件架构的文档,但是在软件开发的过程中没有对软件的变化进行文档记录,导致文档和实际架构不同步。