代码整洁之道--格式

前言

写代码的时候不能仅仅关注代码功能是否完善,也应该主要代码的格式是否符合规范,或许你认为"让代码能工作"才是开发者应该考虑的头等大事,但是,如果没有好的代码格式,在以后版本的迭代和修改中,代码的可读性会对以后发生的修改行为产生深远的影响


来自《代码整洁之道》插图

一、垂直格式

1、自顶向下的去阅读

在你看报纸的是,你会希望有个头条,告诉你报纸的主题,如何第一段是整个故事的大纲,但隐藏了具体细节,接着继续往下读,细节慢慢的呈现,直到你了解整个故事发生的时间,地点等等。
报纸由很多文章组成,多数短小精湛,少数的有点长,但很少有占满一页的,如果报纸只登载一篇特别长的新闻,没人会去读它。
我们的代码也应如此,从上往下,从左往右。

2、概念上的垂直分隔

定义的函数之间,不应该紧紧挨着一起,每个函数之间做好空号分隔;

3、垂直方向向上靠近

紧密相关的代码应该相互靠近,成员变量不留空格

4、紧密关联的函数相互靠近

避免从一个函数跳到另一个函数,这样不停的跳跃。一个函数调用另一个函数,应该尽量保证被调用的函数在调用者的下面挨着,这样阅读更方便。

5、成员变量应该声明在类头部

函数的变量应该在函数开头声明,如果需要函数中声明,考虑是否函数需要拆分成多个函数执行;

二、横向格式

1、一行代码的宽度

保持行代码的短小,避免行代码超过你的屏幕,如果超过,应该考虑换行或者修改更精炼的变量名称

2、水平方向的区隔与靠近

加法、减法、乘法、赋值符合(+、-、==、=)符号直接应该加上空格,表示低优先级,乘法、除法(*、/)之间应该不加空格,表示高优先级,函数参数的逗号之后应该加上空格。

3、水平对齐没有必要

不用这样做,没有必要
在这里插入图片描述

4、代码缩进

即使代码只有一行,也应该写中括号,换行,不要节省篇幅

5、避免循环,判断语句,函数体为空

在多个if判断中,避免某一个语句里什么都不执行

总结

写完代码,最后review code,从上到下检查垂直格式,从左到右检查水平格式
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

i进击的攻城狮

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值