← 返回刚才阅读的位置

知识卡片

普通读书笔记卡 · 2295.e

架构维护易偏离

理解等级:未标注

没有文档良好、维护良好的架构,实现就会不可避免地偏离设计。工具可反向提取实际架构来检查偏离,但依然困难:许多系统本无架构文档,开发人员习惯直接读源码,文档也常未随变化同步。更深的困境是层、子系统等概念只存在于人的脑海中,代码中没有直接载体;靠命名约定暗示结构并不彻底,因为命名与实际结构可能逐渐脱节。另见[[架构与团队同构]]。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • · 查看原书依据

      即使存在描述软件架构的文档,但是在软件开发的过程中没有对软件的变化进行文档记录,导致文档和实际架构不同步。

    参考来源

    - 位置:《软件架构理论与实践》第7章《架构驱动的软件开发》"7.4.2 架构的维护"节(源文件:_epub-src/OEBPS/text00059.html) - 结论依据:原文说明"只是拥有一个软件架构与拥有一个具有良好文档、良好组织结构和良好维护性的架构是完全不一样的。如果没有这些,架构将不可避免地偏离原来的方向",并列出架构提取技术不简单的三个原因,直接支撑本卡片结论。 - 原始内容:许多软件系统没有对架构进行有效的文档化描述。……开发人员往往都是通过源代码进行架构的描述。……即使存在描述软件架构的文档,但是在软件开发的过程中没有对软件的变化进行文档记录,导致文档和实际架构不同步。