代码的规范

糟糕的代码修改往往导致更糟的结果,整洁的代码强调细节处理,避免错误处理、内存泄漏、竞态条件等问题。它追求单一职责,每个部分专注一项任务。整洁的代码应有单元测试和验收测试,使用有意义的命名,提供单一操作路径,减少依赖,并拥有清晰的API。代码应尽可能自我解释,避免过多参数,尤其是避免使用布尔参数。

糟糕的代码引发混乱! 别人修改糟糕的代码时,往往会越改越烂。

往深处说就是在细节上花心思。敷衍了事的错误处理代码 只是程序员忽视细节的一种表现。此外还有内存泄漏,还有 竞态条件代码。还有前后不一致的命 名方式。结果就是凸现出整洁代码对细节的重视。

整洁的代码力求集中。每个函数、每个类和每个模块都全神 贯注于一事,完全不受四周细节的干 扰和污染。

 

它应当有单元测试和验收测试。它使用有意义
的命名。它只提供一种而非多种做一件事的途径。它只有尽量少的依赖关系,而且要明确地定义

和提供清晰、尽量少的 API。代码应通过其字面表达含义,因为不同的语言导致并非所有必需信 息均可通过代码自身清晰表达。

没有测试的代码不干净。不管它有多优雅,不管有多可读、多易理解,微乎测试,其不洁亦可知也

— 能通过所有测试;

— 没有重复代码;
— 体现系统中的全部设计理念;

— 包括尽量少的实体,比如类、方法、函数等。

给这些事取个技术性的名称,通常是 最靠谱的做法。

如果不能用程序员熟悉的术语来给手头的工作命名,就采用从所涉问题领域而来的名称吧。 至少,负责维护代码的程序员就能去请教领域专家了。

优秀的程序员和设计师,其工作之一就是分离解决方案领域和问题领域的概念。与所涉问题
领域更为贴近的代码,应当采用源自问题领域的名称。

最理想的参数数量是零(零参数函数),其次是一(单参数函数),

再次是二(双参数函数),应尽量避免三(三参数函数)。
有足够特殊的理由才能用三个以上参
数(多参数函数)—所以无论如何也不要这么做。

标识参数丑陋不堪。向函数传入布尔值简直就是骇人听闻的做法(该文章是我读《代码整洁之道》的部分摘取相当于笔记的作用)欢迎大家留言勿喷。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值