知识卡片
代码表达意图
内容
代码被阅读的次数远多于被编写的次数，因此清晰表达意图比炫技更重要。命名、结构和语言特性都应帮助读者理解“为什么这样组织”。发散：聪明代码让人佩服一秒，清晰代码让人维护一年。
参考来源
- 位置：第6章《敏捷编码》"25 代码要清晰地表达意图"（源文件：_epub-src/OEBPS/text00000.html）
- 结论依据：原文明确提出PIE原则（Program Intently and Expressively），并用位移操作符代替乘法、`lock(this)`锁范围过大导致潜在死锁等例子说明"聪明但晦涩"的代码会影响正确性而非只是可读性，直接支持卡片结论。
- 原始内容："代码阅读的次数要远远超过编写的次数，所以在编写的时候值得花点功夫让它读起来更加简单。实际上，从衡量标准上来看，代码清晰程度的优先级应该排在执行效率之前。……代码必须明确说出你的意图，而且必须富有表达力……要编写清晰的而不是讨巧的代码。向代码阅读者明确表明你的意图。可读性差的代码一点都不聪明。"