鲍勃大叔的《代码整洁之道》是每个程序员都该读的经典。它的核心观点简单而深刻:代码首先是写给人看的,顺便能在机器上运行。花在让代码清晰上的每一分钟,都会在维护时获得百倍的回报。
命名的艺术
好的命名是代码整洁的基础。变量名应该回答三个问题:为什么存在?做什么事?该怎么用?如果一段代码的名字需要注释来解释,那就说明名字选得不够好。
命名应该从问题域出发——使用业务语言而非技术术语。当你阅读一段代码时,函数调用序列应该读起来像一段散文。
函数应该短小
Bob 大叔的规则是:函数应该非常短小,通常不超过 20 行。每个函数只做一件事、只在一个抽象层级上。switch 语句应该被隐藏在抽象工厂后面,Long if-else 应该重构为多态。
注释是失败的补偿
注释不是越多越好。当你觉得需要写注释时,先尝试重构代码让意图更明显。用代码说"做什么",只在必要时用注释说"为什么这么做"。
代码整洁之道不是关于规则的记忆,而是一种专业态度——对自己写的每一行代码负责。