知识卡片
相关代码宜减少查找距离
共同完成一项任务的声明与操作靠近,读者较容易在同一处取得必要上下文。无信息增量的注释或随意分散的位置会切断这种关系。接近是降低查找成本的组织手段,不意味着所有调用相关类都应塞进一个文件;跨模块边界、复用与职责分离仍可能比物理距离更重要。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 第5章 格式
原书出处 · 3 处
- 第5章 格式 5.2.3 垂直方向上的靠近 · 查看原书依据
关系密切的概念应该互相靠近
- 第16章 重构SerialDate 16.2 让它做对(续) · 查看原书依据
靠近其使用位置的地方
- 第17章 味道与启发 17.4 一般性问题 · 查看原书依据
变量和函数应该在靠近被使用的地方定义
参考来源
- 位置:《代码整洁之道》全书 · 第5章 格式,spine014单元002;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0012.xhtml。
- 结论依据:原文ReporterConfig和跨函数追索说明垂直距离成本,支持就近组织,但“除非理由不分文件”作为取舍保留而非禁止合理模块边界。未在本机运行示例或改变环境。
- 原始内容:和精力在找到和记住那些代码碎片在哪里。 关系密切的概念应该互相靠近[G10]。显然,这条规则并不适用于分布在不同文件中的概念。除非有很好的理由,否则就不要把关系密切的概念放到不同的文件中。实际上,这也是避免使用protected变量的理