细节之中自有天地，整洁成就卓越代码

题图来源 unsplash

前言

踩着三月的尾巴，拜读完了 Bob 大叔的《代码整洁之道》一书，来分享一下阅读心得。(其实我也不知道看了几遍了)

《代码整洁之道》的原名是 Clean Code — A Handbook of Agile Software Craftsmanship.

就像书名一样，本书提出了一个观念：「代码质量与其整洁度成正比」；并且给出了一系列行之有效的代码整洁操作实践。(确实有手册的样子)

通过学习并遵守这些实践建议就能写出整洁的代码。

简评

对于内容我给8分，Bob 大叔的实力自不必说，也确确实实给出了非常非常多的实践原则，并且对坏的代码丝毫不留情面，看了后仿佛遭当头棒喝，醍醐灌顶。

不过该书也有些缺点，比如内容显得有点啰嗦，冗余的内容稍多，并且附录有很多代码，没法看；

另外翻译差评，没见过这么水的翻译，充斥着类似 油漆工模式 这种非常不专业的翻译，多次看的我跳戏，可以说翻译拖了后腿。

总体上还是值得一看的，用来垫显示器也还不错，偶尔可以拿来翻翻，毕竟它的定位是一本 Handbook。

谈下一些阅读心得吧（最后有思维导图版本笔记）。

何为整洁的代码？

该书的第一章讲了 Bob 大叔以及一票国外大佬对 整洁代码的 定义。

我最喜欢的对于整洁的代码的描述是：

1. 整洁的代码总是看起来像是某位特别在意它的人写的；

2. 可读，像散文一样，令人愉悦。

真正用心写代码的人，可以像写散文一样写代码，代码也一定是可阅读的，阅读起来也一定是心情愉悦的，而不是 FxxK。

如何做到写整洁代码？

Bob 大叔真的给了很多实践意见，大到系统，小到类、函数。

举几个例子。

关于命名

选个好名字要花时间，但省下来的时间比花掉的多。

以前我觉得取名字很麻烦，还觉得用缩写很酷，会尽量尝试时用缩写，不管是否能缩写，是否语法正确，最后导致的结果是，没过几天我自己都看不懂这个名字，后来慢慢地就养成了个习惯：不管名字多长，我也要尽力取号名字，保证名字的表达力。

关于函数

函数的第一规则是要短小，提二条规则还是更短小。

基本上超过100行的行数就很有可能是不合格的了，Bob 大叔指导我们写出一个整洁的函数。

关于注释：

别给糟糕的代码加注释，重新写吧

相信你肯定跟我一样，看到过大片被注释掉的代码，不知所云的注释，跟代码实际逻辑完全向左的注释。

Bob 大叔就很直接了，直接指出 注释并不能美化糟糕的代码 、 注释总是一种失败 。

该书适合我吗？

如果你不止一次的遇到如下的情况：

1. 本来只需要几个小时就能做完的需求却花费了数个星期；

2. 本来只需要改一行代码， 却牵扯到 N 多个模块。

说明你的代码不 Clean ，那么我建议你阅读一下本书，并且再配一本设计模式的书，如《深入浅出设计模式》，绝对能够让你写代码的实力提升一个档次；当然想提升一下自己的代码质量，那这本书也是不容错过的哟。

个人建议重点阅读第 1、2、3、4、5、10、17这些章节，其他的看兴趣阅读。

小结

当阅读这本书后，我写代码的时候都仿佛感觉 Bob 大叔就站在我背后，紧盯着我的屏幕，时刻准备挑我代码中的毛病。

福利时间，后台回复：代码整洁之道，获取思维导图版本笔记。（图片太大微信压缩后看不清）

参与打赏，抽取签名版，并带有船长气息的代码整洁之道一本，全世界仅此一次机会，两天后晚9点截止。（记得洗脸先）