首页 > 其他分享 >《代码整洁之道》读书笔记

《代码整洁之道》读书笔记

时间:2023-06-20 14:01:25浏览次数:34  
标签:本书 读书笔记 代码 之道 风格 工具 第三方 整洁


  最初我喜欢这本书可能是因为非技术方面的原因,这本书中有很多我喜欢的插图。这本书的第一章的第一句话是这样说的:读这本书通常有两个原因:1. 你是一名程序员。2. 你想成为更好的程序员。我们需要更好的程序员。

  这本书的每一章都可以总结出一句话,其实每章开始的插图就是这句话的浓缩。

《代码整洁之道》读书笔记_第三方工具


  本书的第一章是关于什么是整洁代码的讨论,引用了Bjarne Stroustrup(C++之父)、Grady Booch(UML的创始人之一)等人当然也Bob大叔(本书的作者Robert Martin)自己对整洁代码的理解。顺便说一下,上面那张图上的代码应该是保龄球计分程序(不知道大家看清楚了没有,哈哈)。


《代码整洁之道》读书笔记_第三方工具_02


  不管是现实世界还是软件项目中,命名都是一件让人头疼的事情,给小孩起过名字的就知道,你希望把你对孩子的期望包含在这个名字中,你又希望这个名字读起来要好听,至少不至于将来成为别人的笑柄(比如庞光大、魏升京这样的名字),可能你还要考虑族谱班辈的排列等等。软件项目中的命名情况会更加复杂,简单的说命名的原则是"见名知意",当然你还需要用各种方式防范命名冲突的问题,不同的编程语言也有自己不成文的像契约一样的命名规则和方式(例如匈牙利命名法),这些可能都是需要考虑的事情。我个人并不喜欢匈牙利命名法,加上一个类型前缀的感觉就是永远和这个东西绑定到一起了,就如同用C语言的malloc函数分配内存创建一个能放100000个元素的数组,你愿意用下面哪种写法呢?记住:好的名字相当于为代码写了一段有用的注释。

int* myArray = NULL;
    /* 写法1 */
    myArray = malloc(100000 * sizeof(int));
    /* 写法2 */
    myArray = malloc(100000 * sizeof *myArray);

《代码整洁之道》读书笔记_第三方工具_03


  第三章讲的是函数,说了这么一句话:"Function should do one thing. They should do it well. They should do it only. "(函数只应该做一件事情,把一件事情做好,而且只由它来做这一件事情),听起来很简单的一句话但是要践行这条原则却并不容易,所以我们的代码中才会有很多的坏味道(请参考《重构:改善既有代码的设计》一书的第三章)。事实上,上升一个层次,我们在设计类的时候也应该如此,这是面向对象设计原则中说的单一职责原则(SRP),当我们的代码中出现了冗长的方法或者巨大的类的时候,我们就应该依据职责来对其进行拆分,这样程序的结构才会趋于合理,最终达到"高内聚"的目标。当然,这一章里面还提到很多理念,包括:Command Query Separation(一个方法要么执行某种命令,要么返回查询数据)、DRY(不要重复自己)、Prefer Exceptions to Returning Error Codes(异常优于返回错误码)等。


《代码整洁之道》读书笔记_代码整洁之道_04


  第四章讲的是注释,有一句话我很喜欢,说的是:"Comments Do Not Make Up for Bad Code."(注释不是对劣质代码的补救)。事实上好的代码即便没有注释也拥有良好的可读性,但恰当的注释会让代码变得更可读、可维护性更高。


《代码整洁之道》读书笔记_读书笔记_05


  第五章讲的是代码风格。现代IDE(集成开发环境)几乎都有代码格式化代码的功能,你只需要设置好你使用的代码风格就可以了,其实不只是IDE,很多高级的文本编辑工具也能够按照指定的风格格式化你的代码。用什么样的代码风格不是关键,关键是整个项目组的成员应当使用相同的代码风格,让多个人编写的代码看起来像一个人书写的。我个在代码中使用的括号风格是1TBS(One True Bracing Style,也叫做K&R风格,这种风格是Kernighan和Ritchie两位老师在"The C Programming Language"一书中使用的代码风格),当然Allman风格(FreeBSD系统的作者之一使用的代码风格)也是很好的选择。


《代码整洁之道》读书笔记_代码整洁之道_06


  第六章讨论的是对象和数据结构,读完之后的感觉是虽然我们天天都嚷着吼着要面向对象编程,但是很多时候我们都使用了类的退化结构,包括我们开发时经常使用的失血模型和贫血模型(事务脚本模式)都和面向对象的设计理念相违背。我得承认在读这一章的时候我可能没有抓住作者的观点。


《代码整洁之道》读书笔记_Java_07


  第七章对错误处理(异常)的讲解非常精彩的,整洁的代码中对错误的处理应当是被分离的关注点(不要跟正常的业务逻辑混杂在一起),而面向对象中的异常机制就是一种在不打乱原有业务逻辑的前提下处理掉程序在运行时发生的不正常状况的手段。这章有两个观点我特别欣赏,一是"Use Unchecked Exceptions"(非受检异常允许你在适当的地方处理异常,而适当的地方就是异常影响代码执行逻辑的地方,不管做哪种类型的应用,都应该尽可能向用户隐藏异常的发生,除非发生了不可挽救的状况,这才是符合最小惊讶原则的设计);二是"Don’t Return Null"(如果一个方法在出状况的时候返回null,那么调用者都要通过频繁的检查返回值来判定是否出错,一旦忘了这件事情就有可能出错,既然null是一种异常状况,那么用抛出异常的方式来代替返回null明显是更好的做法)。


《代码整洁之道》读书笔记_代码整洁之道_08


  第八章的内容对实际开发有重要的指导意义,因为我们的项目中不可避免的要使用第三方工具,因此我们需要将这些东西整洁的纳入到我们的系统中,这时就需要考虑系统边界的问题。有的时候我们会千辛万苦的发现系统中的一些bug是来源于第三方工具的,当然我们基本上没有时间去重头学习和研究第三方工具或者自己写代码来实现第三方工具的功能,但是我们至少应该先对第三方工具进行测试。我在以前的项目中,即使用Apache提供的那些著名的第三方工具,我的做法也是先写测试代码对这些工具的可用性和有效性进行证实,当然有的时候可能是过于谨慎了,但这种习惯和做法本身是很好的。在这种场景下,适配器模式是非常好的设计,它不仅能将不兼容的接口改写成兼容的接口,还能够对通过对第三方工具重新封装来避免边界的变化对系统的影响。


《代码整洁之道》读书笔记_代码整洁之道_09


  第九章的内容是单元测试。Bob大叔是TDD(测试驱动开发)的倡导者,这一章讲的是如何编写整洁的测试,Bob大叔的答案是FIRST规则(Fast、Independent、Repeatable、Self-Validating、Timely)。


《代码整洁之道》读书笔记_第三方工具_10


  第十章介绍类的设计,最重要的还是SRP(单一职责原则)。


《代码整洁之道》读书笔记_Bob大叔_11


  第十一章是关于系统设计的内容,开篇引用了微软首席技术官Ray Ozzie的一句话:"Complexity kills. It sucks the life out of developers, it makes products difficult to plan, build and test."(复杂要人命,它消磨开发者的生命,让产品难于规划、构建和测试)。这章对于希望了解面向切面编程的开发者是极好的,包括了对依赖注入、代理模式以及AOP的探讨。


《代码整洁之道》读书笔记_代码整洁之道_12


  第十二章探讨了系统的迭代式演进。


《代码整洁之道》读书笔记_第三方工具_13


  第十三章对并发编程的讨论非常经常,很多开发者都畏惧并发编程,也有的开发者迷信多线程可以解决所有的并发问题,如果你是这两类人之一,本章会教给你真正的并发编程。这一章的内容我重新整理了一篇文章


《代码整洁之道》读书笔记_Java_14


  第十四章是一个精彩的案例用来讲解对代码的持续改进,你可以自己好好阅读一次。第十五章到第十七章说的都是重构,相当精彩。如果你还没有来得及读《重构:改善既有代码的设计》一书,你可以先读读这几张中探讨的代码的坏味道及其改进方案。


  总之,这本书从引言到附录都无比精彩,书中的代码是用Java语言书写的,赶紧去阅读吧。


标签:本书,读书笔记,代码,之道,风格,工具,第三方,整洁
From: https://blog.51cto.com/u_16166070/6522233

相关文章

  • 关于数据治理的读书笔记 - 数据治理路线图规划
    数据治理成熟度评估为企业提供了一个数据治理的切入点,通过发现企业数据治理中存在的问题,找到目前和业界领先企业的差距,绘制出符合企业现状和需求的数据治理路线图。路线图是指描述技术变化步骤或技术相关环节之间逻辑关系的简洁的图形、表格、文字等形式。数据治理路线图则是对企业......
  • CSAPP读书笔记(第1章)
    编译Hollow程序: gcc-ohellohello.c四阶段的编译系统: 运行hello程序:./hello     这里的点代表啥? 上级吗 ......
  • Java代码精简之道-10条代码精简方案
    场景一、Java中利用try-with-resource语句JDK7开始新增了对需要关闭资源处理的特殊语法try-with-resource。所有实现Closeable接口的“资源”,均可采用try-with-resource进行简化。例如InputStream,OutputStream,Connection,Statement,ResultSet等接口都实现了,使用try-with-reso......
  • HFC读书笔记
    数组变量可以当成指针使用,但有不同的地方:1.sizeof(数组)是数组的大小,而用在指针上返回4或82.&数组变量==数组变量,而&指针不同3.数组变量并没有分配存储空间,所以不能指向其它地方scanf()的用法可参考printf()的用法,需要设置长度,例如字符数组,......
  • 计算机底层的秘密读书笔记之三
    计算机底层的秘密读书笔记之三IO部分之一我感觉IO应该是最可能给人说明白的一个部分了.也是我这种菜鸟改善应用性能最可能的部分了.CPU内存和cache很难有优化的空间.除非是开发去改垃圾代码.后者是升级硬件.但是IO部分我感觉是有很大的优化空间的.1.IO多路复用.因为......
  • 领域驱动设计-软件核心复杂性应对之道 11-13
    11.分析模式的应用马丁分析模式:表示业务建模中的常见构造分析模式的最大作用是借鉴其他项目的经验,把那些项目中所做的广泛的设计方向讨论和实现结果的经验与当前的模型结合起来。记账:钱不会无中生有,也不会无故消失。它只能从一个账户迁移到另一个账户。当你可以幸运地使用一......
  • 计算机底层的秘密读书笔记之二
    计算机底层的秘密读书笔记之二内存部分内存部分之前自己看过很多资料了:主要是虚拟内存以及TLB相关的内容本书的角度与之前角度都不太一样,更加新颖一些.这次总结想倒着来写.1.SSD的带宽和延迟都比较好了,但是是无法代替内存的内存的寻址可以到字节,然后都是按照内......
  • 计算机底层的秘密读书笔记之一
    计算机底层的秘密读书笔记之一摘要上周天在家休息时在知乎上面看到了影响性能的几个场景.里面见到了cache的乒乓问题,以及cacheline的伪共享问题.知乎的答案里面图文并茂.作者的思路也很清晰就顺着水印找到了公众号还有作者刚出版的一本书.京东周一快递到手后,这几天晚......
  • 智安网络|人工智能蔓延,网络安全所面临的威胁和应对之道
    随着人工智能(ArtificialIntelligence,AI)技术的快速发展和广泛应用,我们进入了一个智能时代,人工智能已经蔓延到我们生活的方方面面。然而,与其带来的方便和创新相伴随的是网络安全所面临的新威胁。【威胁一:攻击者利用人工智能技术】人工智能技术的进步为攻击者提供了新的机会和工具。......
  • 视频传输面临的挑战和解决之道
    音视频行业的发展,用户对音视频画质的清晰度、播放的流畅度、互动的低延迟、突破终端限制等的要求越来越高。这些需求从客观上对视频的传输提出更高的挑战,而目前不同业务的视频传输方式各有不同,如何基于视频传输现状,全面系统解决用户需求,成为业界面临的普遍问题。华为云视频架构师黄......