《代码整洁之道》重读：现在我不太同意的一些话

第一次读是在刚入行那年，几乎每一页都想抄下来。今年重读，感受完全不同。

"函数应该尽可能短" —— 我现在认同的是"函数应该只做一件事"，而不是"短"。把一段内聚的逻辑硬拆成五个三行的函数，读者需要在文件里跳来跳去，认知负担反而更重。

"注释是代码的失败" —— 这句话被引用得太多了。代码能表达"怎么做"，但表达不了"为什么这么做"。为什么要在这里加一个看似多余的判空、为什么这个常量是 30 而不是 60 —— 这些只有注释能承载，而且是永远无法被代码替代的那部分。

"不要重复" —— 前提是重复的是同一件"事"，而不是恰好相同的几行代码。为了消除形似而抽象出的公共函数，往往在第三次需求变化时崩溃。

书本身没有问题。它写于那个时代、那个语言生态，给出的是一套理想化的准则。而工程实践的本质，是在约束下做取舍。

所以现在我把这类书当词汇表用：它给了我描述问题的词（内聚、耦合、单一职责），而不是给我决策的答案。