知识卡片

普通读书笔记卡 · 1915.d

一致风格胜过正确

理解等级:未标注

布局一致、相似代码有相似外形、相关行按块组织,能让读者较快识别结构。对不影响程序语义的个人格式偏好,项目内一致通常比坚持某一种自认正确的风格更有帮助。这里比较的是风格约定,不是让一致性压倒语法、正确性或真实可读性;有实际缺陷的约定仍应有据改进。

大括号位置示例比较的是可合法采用的个人格式选择;项目内混用会打断预期。若语言以缩进表达结构或某规则有实质缺陷,仍须先保持语义与正确性。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 3 处

    • · 查看原书依据

      使用一致的布局,让读者很快就习惯这种风格。 ·让相似的代码看上去相似。 ·把相关的代码行分组,形成代码块。 审美与设计 在本章中,我们只关注可以改进代码的简单“审美”方法。这些类型的改变很简单并且常常能大幅地提高可读性。有时大规模地重构代码(例如拆分出新的函数或者类)可

    • · 查看原书依据

      一致的风格比“正确”的风格更重要。

    • · 查看原书依据

      用一致的、有意义的方式“格式化”,可以把代码变得更容易读,并且可以读得更快。 下面是讨论过的一些具体技巧: ·如果多个代码块做相似的事情,尝试让它们有同样的剪影。 ·把代码按“列”对齐可以让代码更容易浏览。 ·如果在一段代码中提到A、B和C,那么不要在另一段中说B、C和

    参考来源

    - 位置:《编写可读代码的艺术》第4章:审美与代码布局(spine 2785;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2709.html`;来源键`s2785-ch04-001`)。 - 结论依据:本项正文及图77..102完整实读;按既有语义前提理解版式改进,不把外观或布局约定当正确性保证。 - 原始内容:使用一致的布局,让读者很快就习惯这种风格。 ·让相似的代码看上去相似。 ·把相关的代码行分组,形成代码块。 审美与设计 在本章中,我们只关注可以改进代码的简单“审美”方法。这些类型的改变很简单并且常常能大幅地提高可读性。有时大规模地重构代码(例如拆分出新的函数或者类)可 - 位置:《编写可读代码的艺术》个人格式偏好与项目一致性(spine 2792;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2716.html`;来源键`s2792-ch04-001`)。 - 结论依据:本项正文及图77..102完整实读;按既有语义前提理解版式改进,不把外观或布局约定当正确性保证。 - 原始内容:一致的风格比“正确”的风格更重要。 - 位置:《编写可读代码的艺术》第4章小结(spine 2793;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2717.html`;来源键`s2793-ch04-001`)。 - 结论依据:本项正文及图77..102完整实读;按既有语义前提理解版式改进,不把外观或布局约定当正确性保证。 - 原始内容:用一致的、有意义的方式“格式化”,可以把代码变得更容易读,并且可以读得更快。 下面是讨论过的一些具体技巧: ·如果多个代码块做相似的事情,尝试让它们有同样的剪影。 ·把代码按“列”对齐可以让代码更容易浏览。 ·如果在一段代码中提到A、B和C,那么不要在另一段中说B、C和