知识卡片
相似代码应有相似外形
多段代码做同类事情时,保持相近换行和参数排列,可让读者快速比较差异,避免某一段仅因长度突出而被误认为语义特别。可把共同说明移到表头或统一结构,但要权衡纵向空间和说明距参数的距离。外形服务比较,不能为对齐而改变实际操作顺序或隐藏必要条件。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- · 查看原书依据
相似的代码应当看上去相似”这条原则。 为了让代码看上去更一致,我们可以引入更多的换行(同时还可以让注释对齐) 这段代码有优雅一致的风格,并且很容易从头看到尾快速浏览。但遗憾的是,它占用了更多纵向的空间。并且它还把注释重复了3遍。 下面是写这个类的更紧凑方法: 我们把注释
参考来源
- 位置:《编写可读代码的艺术》让相似代码具有一致外形(spine 2786;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2710.html`;来源键`s2786-ch04-004`)。
- 结论依据:本项正文及图77..102完整实读;按既有语义前提理解版式改进,不把外观或布局约定当正确性保证。
- 原始内容:相似的代码应当看上去相似”这条原则。 为了让代码看上去更一致,我们可以引入更多的换行(同时还可以让注释对齐) 这段代码有优雅一致的风格,并且很容易从头看到尾快速浏览。但遗憾的是,它占用了更多纵向的空间。并且它还把注释重复了3遍。 下面是写这个类的更紧凑方法: 我们把注释