良好的 编码 规范和习惯会让你的代码锦上添花,同时也会大大的增加团队协作开发的效率,避免很多细节的问题,从而大大的提高你的代码的可阅读性,同时也是一个优秀开发者的必备技能之一,所以接下来,我们就一起来了解并掌握一些常见的编码规范吧。
一、命名规范
类名的首字母必须大写。
所有成员变量、方法命名时,必须遵守 骆驼命名法 。
【PS:骆驼式命名法就是当变量名或函式名是由一个或多个单词连结在一起,而构成的唯一识别字时, 第一个单词以 小写字母 开始;第二个单词的首字母大写或每一个单词的首字母都采用大写字母,例如:myFirstName、myLastName, 这样的变量名看上去就像骆驼峰一样此起彼伏,故得名—— 骆驼命名法,也叫驼峰命名 】
范例:
一般 运算符 两边都必须有空格+、-、*、/、%、=、<、>、!=、<=、>= 两边空格,如:
一元运算可以除外,比如:i++; i–; ++i; –i;
书写{ }采用如下格式:
抽象类以Abstract开头;
接口的实现使用Impl结尾;
静态不可变的变量全部使用大写,并且单词之间用_进行分隔:如
包名由小写字母和少量数字组成,包名统一用代表模块贴切含义的英文单词或缩写;
例如老九学堂的项目是这样命名的:
包名 一级为com;
包名 二级为xuetang9;
包名 三级为班级编号,prot001;
包名 四级为小组名,如crazy;
包名 五级按功能模块划分等,如oofood;
所以包名为: com.xuetang9.prot001.crazy.oofood
二、注释要求
注释是帮助程序读者的一种手段在编码的过程中必须随时加注释,不能过后补齐。通过注释描述当时的思路,以及悬而未决的问题;提高程序的可读性,规范性,维护性。提供使用说明、及配置信息。
1.每行注释不超过40个中文字;
2.每个类、接口的开头必须多行的详细的功能说明,使用中文注释,包括作者、版本、创建时间等等;
3.每個方法前面都必須使用 Javadoc 的中文注释,必须说明该方法的作用与目的;
4.每个成员变量必须有单行中文注释,必须说明该成员变量的作用与目的。
类注释
方法注释
方法头注释必须包括:方法执行了什么功能,为什么要这样处理;方法处理过程中对对象的那些属性可能进行更改;方法执行前后,对象的状态。
1. 比较、循环等控制结构必须加注释;
2. 在代码的功能并非一目了然的情况下,应当说明为什么要这样做;
3. 局部变量 必须加注释;
4. 复杂难写的代码必须加注释;
5. 如果一系列代码的前后执行顺序有要求,必须注释说明 方法开头需要的注释内容: 作者、功能、参数说明、返回值、例外、日期、修改日期,修改人,修改原因。
举例:
变量注释
要求注释所有的变量(域)。如下所示: