知识卡片
为读者降低修改前的理解成本
修改代码通常需要先查看调用、初始化及周边实现,理解成本会进入每次修改的成本。命名和组织应让后来的人更容易取得必要上下文,即使初次写作多花一些时间。编辑器回放和读写10:1是作者的观察说明,未给可推广样本;它提示关注阅读,不构成所有任务固定比例或必须无限整理的标准。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 第1章 整洁代码
原书出处 · 3 处
- 第1章 整洁代码 1.5 我们是作者 · 查看原书依据
写新代码时,我们一直在读旧代码
- 第12章 迭进 12.4 不可重复(续) · 查看原书依据
其他维护者不会那么深入
- 第17章 味道与启发 17.4 一般性问题(续) · 查看原书依据
将代码的意图呈现给读者
参考来源
- 位置:《代码整洁之道》全书 · 第1章 整洁代码,spine010单元005;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0008.xhtml。
- 结论依据:原文回放修改时反复浏览上下文,支持阅读影响写作成本;10:1保留为作者叙述,未登记为本机统计或普遍测量。未在本机运行示例或改变环境。
- 原始内容:白了。读与写花费时间的比例超过10:1。写新代码时,我们一直在读旧代码。 既然比例如此之高,我们就想让读的过程变得轻松,即便那会使得编写过程更难。没可能光写不读,所以使之易读实际也使之易写。 这事概无例外。不读周边代码的话就没法写代码。编写