知识卡片
向下阅读使调用层次可追踪
先给出当前任务,再依次解释它调用的下一层步骤,读者就能由整体走到细节,而不必先读完字符串拼装才知道用途。TO段落法用“为了完成某事,先做哪些事”检查这种结构。它是源代码组织与阅读路径,不是程序执行必然按文件顺序;共享函数或递归也不应为排版强行复制。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 6 处
- 第3章 函数 3.3 每个函数一个抽象层级 · 查看原书依据
我把这叫做向下规则
- 第5章 格式 第5章 格式 · 查看原书依据
源文件也要像报纸文章那样
- 第5章 格式 5.2.4 垂直距离(续) · 查看原书依据
相关性应建立在直接依赖的基础上
- 第5章 格式 5.2.5 垂直顺序 · 查看原书依据
被调用的函数应该放在执行调用的函数下面
- 第10章 类 第10章 类 · 查看原书依据
符合了自顶向下原则
- 第15章 JUnit内幕 15.1 JUnit框架(续) · 查看原书依据
每个函数的定义都正好在其被调用的位置后面
参考来源
- 位置:《代码整洁之道》全书 · 第3章 函数,spine012单元003;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0010.xhtml。
- 结论依据:原文连续TO段落由设置到套件再到继承页展开,直接支持层次化说明,未将函数声明位置混成运行时调度。未在本机运行示例或改变环境。
- 原始内容:看函数列表时,就能偱抽象层级向下阅读了。我把这叫做向下规则。 换一种说法。我们想要这样读程序:程序就像是一系列 TO起头的段落,每一段都描述当前抽象层级,并引用位于下一抽象层级的后续TO起头段落。 To include the