`

代码整洁之道

阅读更多

代码质量和整洁度成正比

 

有意义的命名,原则:

名副其实(用注解来补充的命名不是名副其实);

避免误导,避免使用与本意相悖的词汇;

做有意义的区分:Variable永远不要出现在变量中,Table永远不要出现在表中,废话是冗余的;

使用读得出来的名称;

使用可搜索的名称(单字母和数字常量很难搜索,exceptione也不好搜索);

单字母名称仅用于短方法的本地变量,名称长度应与其作用域大小相对应;

避免使用编码;

不必使用m_成员前缀来表明是成员变量;

接口的I前缀不如实现的imp后缀;

避免思维映射:不应当让读者把你的名称理解为他们熟知的内容;

类名和对象名应该是名词或名词短语,不应该是动词;

方法名应该是动词或动词短语;

每个概念对应一个词;

别用双关语:同一单词用于不同目的;同一术语用于不同概念;

使用解决方案领域名词;

使用领域术语;

添加有意义的语境;

 

一言以蔽之:取名最难的地方在于需要良好的描述技巧和工有的文化背景。

 

函数

第一原则是函数要短小;第二条原则还是更短小。

一个函数只做一件事,并做好这件事(判断是不是做了一件事:看能不能再拆分一个函数出来);

每个函数一个抽象级;

Switch语句:放于接口中,继承类则隐藏该部分,实现函数短小;

函数命名使用描述性的名称;

 

函数参数

最理想的是0参数,尽量少用3个参数以上的;多于的话,要考虑封装成类;

使用异常代替错误返回码;

抽离try catch块,将try中的逻辑封装成函数;

 

注释

注释存在的时间越久,就离其描述的代码越远,越累越变得全然错误,原因在于,程序员不能坚持维护注释

 

注释不能美化糟糕的代码;

唯一真正好的注释是不去写注释;

注释可以用于放大某种不合理的事物的重要性;

 

坏注释:

喃喃自语:如果决定要写注释就要写好注释;

误导性注释

错误注释

日志式注释:记录代码的修改——冗长的记录只会让模块变得凌乱不堪,删掉

 

能用函数或变量时就别用注释

 

归属和署名不必放在代码中,代码管理工具是这些信息的归属地

直接把代码注释掉是讨厌的做法

HTML注释不要存在于代码中;

非本地注释:注释内容与被注释代码脱离上下文关系;

 

短函数的函数头注释不如起个好的函数名字;

 

格式

代码格式关乎沟通,沟通是专业开发者的头等大事

 

纵向格式

尽可能用200行,不超过500行的代码文件

 

变量应该尽可能靠近其使用位置;

实体变量在类顶部声明;

相关函数:调用者放在被调用方法的上部;

概念相关:概念相关性强的代码放在一起;

 

横向格式

代码行尽量短小

方法名和左括号不必加空格,参数一一隔开;

 

 

对象和数据结构

对象把数据藏于抽象之后,暴露操作数据的函数;数据结构暴露数据;

 

对象和数据结构的二分原理:

过程式代码(使用数据结构)在于不改变既有数据结构的前提下增加新函数,面向对象的代码便于在不改变既有函数的前提下增加新类.

反之,过程式代码难以添加新的数据结构,因此必须修改所有函数.面向对象代码难以新函数,因为要修改所有类.

 

数据传送对象:DTO,只有公共变量,没有函数

 

错误处理

使用异常而非返回码

别返回null,别传递null

 

边界

使用第三方代码

 

类要短小:单一全责原则

内聚

 

系统

将系统的构造和使用分开

 

迭代

通过迭代设计达到整洁的目的

 

 

 

分享到:
评论

相关推荐

    代码整洁之道读书分享.zip

    阅读《代码整洁之道》这本书的《逐步改进》、《JUnit内幕》这两章内容时写的demo

    读代码整洁之道幻灯片笔记

    代码整洁之道是一本主要写代码规范的书籍,我读完以后为了给同事们分享里面的重点知识,做了几个幻灯片,主要是各个知识点和笔记。

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

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

    代码整洁之道笔记

    个人阅读代码整洁之道所做的笔记

    代码整洁之道读书笔记.zip

    * 整洁代码的意义? 可读性,可维护性。 * 如何写出整洁代码? 1.只做一件事 2.不重复 3.有表达力 * 整洁代码的态度要求,要遵守的军规? 专业 和责任。让营地比你来时更干净,拒绝破窗效应。 * 写出整洁...

    代码整洁之道幻灯片笔记

    这是有关代码整洁之道的幻灯片笔记,简单介绍了本书的一些重点知识点。

    代码坏味道与启发--《代码整洁之道》总结.pdf

    代码坏味道与启发--《代码整洁之道》总结.pdf

    代码整洁之道-----读书笔记

    代码整洁之道读书笔记

    《代码整洁之道》学习笔记

    该文档是《代码整洁之道》的经典语句,能够帮助读者了解该书的主要内容。同时,本文档对软件工程师的工作也有一定的帮助!

    代码整洁之道内容概括

    一个偶然的机会读了代码整洁之道,觉得这本书写的很好,所以就将里面自己觉得很经典的内容记录下来,作为自己以后写代码的标准和准则。同时也为那些曾经困惑过的人一点参考吧~!1.需求与代码哪个重要?答:并不是...

    CleanCode代码整洁之道培训总结(2015-03-14)-附件资源

    CleanCode代码整洁之道培训总结(2015-03-14)-附件资源

    浅谈JavaScript 代码整洁之道

    它们仅用于参考,不过要知道这些原则都是《代码整洁之道》的作者们累积多年的集体经验。 我们在软件工程方面的技术发展刚刚超过 50 年,我们仍然在学习很多东西。当软件架构和架构本身一样古老的时候,我们应该遵循...

    读代码整洁之道

    现在的软件系统开发难度主要在于其复杂度和规模,客户需求也不再像WinstonRoyce瀑布模型期望那样在系统编码...在《代码整洁之道》(Clean Code),提出一种软件质量,可持续开发不仅在于项目架构设计,还与代码质量密切

    你所需要知道的代码整洁之道1

    声明代码的层次意图,明显的细节在注释中使输/输出例进说明代码中的缺陷,使标记标记通常的意义还没处理的事情已知的法运的代码对个问题不得不采的价粗糙的解决案命名关键

Global site tag (gtag.js) - Google Analytics