整洁代码之道 [3] - 函数，注释，和格式

函数

函数要尽可能短，缩进有一到两级，包含20行代码就是最好了。

if／else／while只占一行

一个函数只完成一件事情，这件事情要看当前函数处于什么抽象级别。要让代码拥有自顶向下的阅读顺序。

可以用多态替代switch。

函数要具有描述性的名称。长函数名称比长注释好。函数参数要少。参数多了，单元测试就麻烦了。

最好别传布尔值，而是直接替换为两个函数。如果参数过多，请封装为类 。尽量避免使用输出参数，如果需要则修改所属对象的状态

使用异常替代返回错误码

编写程序就是讲述故事。

注释

什么也比不上放置良好的注释来的有用。什么也不会比乱七八糟的注释更有本事搞乱一个模块。

注释意味着失败。

有时候如果注释的是和代码无关的反而认为是好注释，如版权信息，对可能的代码维护人的提醒

格式

像报纸文章一样规范自己的代码。参考某某编码规范吧！