代码规范的优点
1.提高代码可读性:遵循统一的代码风格,可以使代码更易于阅读、理解和维护,从而提高代码的可读性和可维护性。
2.降低代码出错率:代码规范可以帮助开发人员避免一些常见的编程错误,从而减少代码的错误率。
3.提高团队协作性: 统一了代码规范,有利于不同的开发人员之间的交流与协作。也让整个团队得到提升。
1.命名方式
- 命名语义化,能够达到顾名思义
- 使用完整单词,切忌自行缩短单词。
常见的命名规范
类的命名 (单词首字母大写) 例如: User
方法的命名 (首字母小写,字母开头大写) 例如:getUserInfo
常量的命名 (全部大写 ,常加下划线) 例如:MAX_VALUE
2.简洁注释
- 能知道是做干什么的,清晰明了干净
- 注释尽可能使用“//”;对于所有的javadoc的注释则使用“/** /”;而临时对代码块进行注释尽量使用“/ */”。
- (2)所有的源文件都应该在开头有一个注释,其中列出文件名、日期和类的功能概述。
- (3)每个方法必须添加文档注释(类的main()方法除外)。
- (4)每个属性必须添加注释。
- (5)代码中至少包含15%的注释。
- (6)注释使用中文。
3.一行代码长度
- 保证自己一行代码自己能看完,看不完就下一行。
- 方便别人看你代码的时候不用看完这行,不知道看到哪行了。
4.删除多余无用的代码块
5.Java文件名规范
- 一个Java源文件只能储存一个Java类
- 文件名和Java类的类名相同。
6. 声明规范
- 不要将不同的类型变量放在同一行。
- 只在代码开始声明变量,所有的变量必须在声明时初始化。
- 避免声明的变量覆盖上一层的变量
- 方法与方法以空行隔开
7.语句规范
- if语句要用{}大括号括起来
- return语句,返回值不能用()