前言
踩着三月的尾巴,拜读完了 Bob 大叔的《代码整洁之道》一书,来分享一下阅读心得。(其实我也不知道看了几遍了)
《代码整洁之道》的原名是 Clean Code — A Handbook of Agile Software Craftsmanship.
就像书名一样,本书提出了一个观念:「代码质量与其整洁度成正比」;并且给出了一系列行之有效的代码整洁操作实践。(确实有手册的样子)
通过学习并遵守这些实践建议就能写出整洁的代码。
简评
对于内容我给8分,Bob 大叔的实力自不必说,也确确实实给出了非常非常多的实践原则,并且对坏的代码丝毫不留情面,看了后仿佛遭当头棒喝,醍醐灌顶。
不过该书也有些缺点,比如内容显得有点啰嗦,冗余的内容稍多,并且附录有很多代码,没法看;
另外翻译差评,没见过这么水的翻译,充斥着类似 油漆工模式 这种非常不专业的翻译,多次看的我跳戏,可以说翻译拖了后腿。
总体上还是值得一看的,用来垫显示器也还不错,偶尔可以拿来翻翻,毕竟它的定位是一本 Handbook。
谈下一些阅读心得吧(最后有思维导图版本笔记)。
何为整洁的代码?
该书的第一章讲了 Bob 大叔以及一票国外大佬对 整洁代码的 定义。
我最喜欢的对于整洁的代码的描述是:
整洁的代码总是看起来像是某位特别在意它的人写的;
可读,像散文一样,令人愉悦。
真正用心写代码的人,可以像写散文一样写代码,代码也一定是可阅读的,阅读起来也一定是心情愉悦的,而不是 FxxK。
如何做到写整洁代码?
Bob 大叔真的给了很多实践意见,大到系统,小到类、函数。
举几个例子。
关于命名
选个好名字要花时间,但省下来的时间比花掉的多。
以前我觉得取名字很麻烦,还觉得用缩写很酷,会尽量尝试时用缩写,不管是否能缩写,是否语法正确,最后导致的结果是,没过几天我自己都看不懂这个名字,后来慢慢地就养成了个习惯:不管名字多长,我也要尽力取号名字,保证名字的表达力。
关于函数
函数的第一规则是要短小,提二条规则还是更短小。
基本上超过100行的行数就很有可能是不合格的了,Bob 大叔指导我们写出一个整洁的函数。
关于注释:
别给糟糕的代码加注释,重新写吧
相信你肯定跟我一样,看到过大片被注释掉的代码,不知所云的注释,跟代码实际逻辑完全向左的注释。
Bob 大叔就很直接了,直接指出 注释并不能美化糟糕的代码 、 注释总是一种失败 。
该书适合我吗?
如果你不止一次的遇到如下的情况:
本来只需要几个小时就能做完的需求却花费了数个星期;
本来只需要改一行代码, 却牵扯到 N 多个模块。
说明你的代码不 Clean ,那么我建议你阅读一下本书,并且再配一本设计模式的书,如《深入浅出设计模式》,绝对能够让你写代码的实力提升一个档次;当然想提升一下自己的代码质量,那这本书也是不容错过的哟。
个人建议重点阅读第 1、2、3、4、5、10、17这些章节,其他的看兴趣阅读。
小结
当阅读这本书后,我写代码的时候都仿佛感觉 Bob 大叔就站在我背后,紧盯着我的屏幕,时刻准备挑我代码中的毛病。
福利时间,后台回复:代码整洁之道,获取思维导图版本笔记。(图片太大微信压缩后看不清)
参与打赏,抽取签名版,并带有船长气息的代码整洁之道一本,全世界仅此一次机会,两天后晚9点截止。(记得洗脸先)