知识卡片
一致风格胜过正确
布局一致、相似代码有相似外形、相关行按块组织,能让读者较快识别结构。对不影响程序语义的个人格式偏好,项目内一致通常比坚持某一种自认正确的风格更有帮助。这里比较的是风格约定,不是让一致性压倒语法、正确性或真实可读性;有实际缺陷的约定仍应有据改进。
大括号位置示例比较的是可合法采用的个人格式选择;项目内混用会打断预期。若语言以缩进表达结构或某规则有实质缺陷,仍须先保持语义与正确性。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 一致风格胜过正确
- · 个人格式偏好与项目一致性
- · 第4章小结
原书出处 · 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和