前言
写代码的时候不能仅仅关注代码功能是否完善,也应该主要代码的格式是否符合规范,或许你认为"让代码能工作"才是开发者应该考虑的头等大事,但是,如果没有好的代码格式,在以后版本的迭代和修改中,代码的可读性会对以后发生的修改行为产生深远的影响
一、垂直格式
1、自顶向下的去阅读
在你看报纸的是,你会希望有个头条,告诉你报纸的主题,如何第一段是整个故事的大纲,但隐藏了具体细节,接着继续往下读,细节慢慢的呈现,直到你了解整个故事发生的时间,地点等等。
报纸由很多文章组成,多数短小精湛,少数的有点长,但很少有占满一页的,如果报纸只登载一篇特别长的新闻,没人会去读它。
我们的代码也应如此,从上往下,从左往右。
2、概念上的垂直分隔
定义的函数之间,不应该紧紧挨着一起,每个函数之间做好空号分隔;
3、垂直方向向上靠近
紧密相关的代码应该相互靠近,成员变量不留空格
4、紧密关联的函数相互靠近
避免从一个函数跳到另一个函数,这样不停的跳跃。一个函数调用另一个函数,应该尽量保证被调用的函数在调用者的下面挨着,这样阅读更方便。
5、成员变量应该声明在类头部
函数的变量应该在函数开头声明,如果需要函数中声明,考虑是否函数需要拆分成多个函数执行;
二、横向格式
1、一行代码的宽度
保持行代码的短小,避免行代码超过你的屏幕,如果超过,应该考虑换行或者修改更精炼的变量名称
2、水平方向的区隔与靠近
加法、减法、乘法、赋值符合(+、-、==、=)符号直接应该加上空格,表示低优先级,乘法、除法(*、/)之间应该不加空格,表示高优先级,函数参数的逗号之后应该加上空格。
3、水平对齐没有必要
不用这样做,没有必要
4、代码缩进
即使代码只有一行,也应该写中括号,换行,不要节省篇幅