《Clean Code》读书笔记——第二周

本周我阅读了《Clean Code》。

“神在细节中！”，建筑家范德罗如是说。他当然专注于基于宏伟构架之上的永恒建筑形式，他也同样为自己设计的建筑挑选门把手。同样软件开发也是这样，小处见大。在宏伟的建筑作品中，我们也要关注细节的回响。重点便是整理，从而达成Clean。一个很好的例子是对于变量命名，认真对待每个变量名。书中作者说，我们就像一群代码猴子，无视混乱无序，失去代码的真谛。整洁的代码正是迈向编程之美的基础，重要性毋庸置疑。

作者断言，我们永远需要代码。我们可以创造各种工具，但是永远无法抛弃必要的精确性，代码呈现了需求的细节。糟糕的代码可能毁了一个公司，一个工程，整洁的代码不仅有关效率，还有有关生存。勒布朗法则说：稍后等于永不。我们不能寄希望于稍后清理，抱着混乱代码好于没有代码的态度开发。完成课程任务时，我们往往以得到一段可以运行的代码为目标，不注意各种细节，一旦出现问题，需要重构代码，可能连把自己的代码读一遍都痛苦万分。整洁的代码将有利于后期开发，方便他人或者自己随后的阅读。

那么什么是整洁的代码呢？书中询问了一些知名的程序员，获得了众多答案。

1. 优雅高效，整洁的代码只做一件事
2. 简单直接，如同优美的散文
3. 便于他人增改
4. 对代码全心投入
5. 没有重复代码

当然这是他们的观点，每个人都可能得到他们自己的答案，并没有真正的权威答案。就我个人看来，整洁的代码应当高效清晰，便于阅读修改，逻辑结构鲜明，更抽象一点，有简洁的美感。是的，要有美感，这种美感来自于程序员编写代码是的清晰逻辑架构，函数的高效使用，以及细节的投入。

软件中随处可见命名，这一细节虽小，对于代码的可读性有很大的影响。书中给出了一些简单的规则，首先应当让命名名副其实，避免误导，作有意义的区分，比如把抽象的单字母变量换成英语单词，这显然会极大增强代码可读性和可描述性。是想C语言和其他高级语言，想必汇编或者机器语言，让人感到简单方便的重要方面就是各种操作被冠以英语单词的‘名字’，同样读得出来，有意义的命名会极大改善你的代码。同时也要注意回避 ‘扮可爱’（试图有趣的命名），双关，添加没用的语境等。

函数是语言的动词，类是名词。函数是代码必不可少的重要部分，要写好函数首先要明白函数是对具体操作的抽象，每个函数里面嵌套一个函数就是一个抽象层级。混杂不同的抽象层级会导致混乱，失去简介。具体的，函数应该做一件事，做好这件事，只做这件事。这样你会收获一个高效简洁的函数，一般而言，这会是一个短小的函数，符合函数编写的第一原则。

初学C语言，重要的一课是如何添加注释，如何规范清晰地添加注释。好的注释可以提供函数使用的信息，对编写意图进行阐释，或者警示其他程序员要注意的细节。但是，注释不是糟糕代码的遮羞布，混乱的逻辑不会因为被描述就变得清晰，好的注释建立在好的代码基础上。过多的注释有时会引起相反的效果，信息过多就是废话，也难以抓住重点。