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

joyee-zhou-1449764-unsplash.jpg

前言

踩着三月的尾巴,拜读完了 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 大叔就站在我背后,紧盯着我的屏幕,时刻准备挑我代码中的毛病。

关注公众号,后台回复:代码整洁之道,获取思维导图版本笔记。

程序亦非猿 wechat
都看到这里了,不关注下我的公众号吗?

热评文章