Home »  杂记 » 代码简洁之道(习惯篇)

代码整洁之道(习惯篇)

整洁的代码

混乱的代价

只要你干活两三年编程,就有可能曾被某些人糟糕的代码绊倒过。如果不只两三年,这种情况可能会更加验证。 有些团队在项目初期进展迅速,但有那么一两年的时间缺慢如蜗行。对代码的每次修改都会影响到其他两三处。

整洁代码的艺术

这种情况下老大要赶速度,而开发者们背负压力,只要在混乱中继续混乱,他们没有花时间想让自己做的更快上面。 鲍勃大叔提出:“保持代码的整洁性,是提高编码效率减少维护成本的唯一方法”。 写代码很像绘画,多数人能分辨出一幅画是好是坏,能分辨出优劣不代表懂得绘画。 写整洁代码需要遵循大量的小技巧,贯彻刻苦习得的整洁感。简言之,编写整洁代码的程序员就像是艺术家。

有意义的命名

名副其实

避免误导

做有意义的区分

使用读出来的名称

使用可搜索的名称

别扮可爱

每个概念对应一个词

别用双关语

使用解决方案领域的名称

使用源自问题领域的名称

添加有意义语境的名称

不要添加没用的语境

函数

短小

只做一件事情

使用描述性的名称

函数参数

最理想0参数,其次是单一参数,再次是二,应避免三,以及三以上

标示参数丑陋不堪

使用异常替代返回错误码

注释

“别给糟糕的代码加注释,重新写吧” XXX

格式

团队规范第一

错误处理

使用异常而非返回码

先写try catch

定义异常类

强固与可读不冲突,将错误处理独立于主要逻辑之外,就能写出强固而整洁的代码。 做到这一步,我们就能单独处理它,大大提升了代码的可维护性。

边界

使用第三方代码

耦合

单元测试