知识卡片

普通读书笔记卡 · 1915.d.1

相似代码应有相似外形

理解等级:中级

多段代码做同类事情时,保持相近换行和参数排列,可让读者快速比较差异,避免某一段仅因长度突出而被误认为语义特别。可把共同说明移到表头或统一结构,但要权衡纵向空间和说明距参数的距离。外形服务比较,不能为对齐而改变实际操作顺序或隐藏必要条件。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • · 查看原书依据

      相似的代码应当看上去相似”这条原则。 为了让代码看上去更一致,我们可以引入更多的换行(同时还可以让注释对齐) 这段代码有优雅一致的风格,并且很容易从头看到尾快速浏览。但遗憾的是,它占用了更多纵向的空间。并且它还把注释重复了3遍。 下面是写这个类的更紧凑方法: 我们把注释

    参考来源

    - 位置:《编写可读代码的艺术》让相似代码具有一致外形(spine 2786;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2710.html`;来源键`s2786-ch04-004`)。 - 结论依据:本项正文及图77..102完整实读;按既有语义前提理解版式改进,不把外观或布局约定当正确性保证。 - 原始内容:相似的代码应当看上去相似”这条原则。 为了让代码看上去更一致,我们可以引入更多的换行(同时还可以让注释对齐) 这段代码有优雅一致的风格,并且很容易从头看到尾快速浏览。但遗憾的是,它占用了更多纵向的空间。并且它还把注释重复了3遍。 下面是写这个类的更紧凑方法: 我们把注释