Logo

郎哥编程

编码规范

2019-12-08 1001

每个开发者都有自己的编程风格,有的代码写得很漂亮,结构清晰,易读易理解;有的代码写的就比较散乱,易读性不强,让人有读天书的感觉,更不用说理解了;有的代码写的错误频出,调试排错耗费太多时间。IT公司对后两种开发者都是避而远之的。Java初学者自然不想做后者,那么就从现在开始养成良好的编程风格和习惯。

命名规则

开发Java程序需要对包、类文件、方法、变量、接口进行命名。有些开发者图省心,对上面元素的命名采用拼音的方式,给代码的审查和维护带来很大麻烦。特别是在团队分工合作的项目中,因为用拼音不能见名知义,会产生很大的代码沟通障碍。所以,在开发过程中,遵循命名规则特别重要。

下面从命名的基本要求、类和接口命名、方法命名、参数与变量命名进行说明。

(1)命名基本要求

命名含义清晰、不易混淆,使用标准的英文单词或缩写,若使用特殊约定或缩写,则要有注释说明。

(2)类和接口命名

Java中的类和接口命名应以大写字母开头,其他字母都小写的英文单词组成。类应以名词或名词短语命名,并体现类的作用。接口的名称取决于接口的主要功能和用途。如果接口是使对象具有某种特定的功能,则接口的名称宜使用可描述这种功能的形容词,否则使用名词或名词短语。

(3)方法命名

类的方法命名采用大小写混合的形式,以小写字母开头,名字中其他单词的首字母以大写字母开头,所有其他的单词都为小写字母,不应使用下划线分隔单词,并且命名应描绘方法的作用和功能。

其中获取或设置类的某种属性的方法应显式的命名为 getProperty(),或setProperty(),其中property为类的属性名称。

(4)参数与变量命名

参数与变量的命名应采用大小写混合的形式,以小写字母开头,名称中其他单词或只取首字母的缩写单词要以大写字母开头,所有其他的单词均为小写字母,不应使用下划线分隔单词。

对于变量命名,禁止取单个字符(如i、j、k...),但i、j、k作局部循环变量允许使用。

程序中使用的常量和枚举需要由全部大写的多个单词组成的说明型名称,每个单词之间用下划线分隔。

编码格式要求

格式要求即代码的排版要求,规范的代码排版可以提高程序的易读性,也容易发现代码存在的问题。下面给出了具体的排版规范要求。

(1)代码行的长度

a)  单行不应超过80个字符,较长的语句要分成多行书写;

b)  if、for、do、while、case、switch、default等语句独自占一行;

c)   语句应在逗号分隔符处划分新行;

d)  表达式在操作符处划分新行,操作符放在新行之首;

e)  划分出的新行要进行适当的缩进,使排版整齐,语句可读。

(2)缩进

缩进基本要求如下:

a)  程序块要采用缩进风格编写,缩进的空格数为4个;

b)  在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。

(3)空行

相对独立的程序块之间、变量说明之后应加空行。在下列情况下应使用一个空行:

a)  在版权声明块、包声明块、引用声明块之后;

b)  在类的声明之间;

c)   在方法的声明之间;

d)  在类中声明最后一个属性之后,声明第一个方法之前。

(4)空格

在两个以上的关键字、变量、常量进行对等操作时,操作符之前、之后或前后应加空格;进行非对等操作时,如果是关系密切的立即操作符(如->)后不应加空格。应遵循以下约定:

在两个以上的关键字、变量、常量进行对等操作时,操作符之前、之后或前后应加空格。

Java类、方法、变量等的命名需要遵循见名知义的原则,并全部采用英文单词或缩写。类和接口命名应以大写字母开头,其他字母都小写的英文单词组成。类应以名词或名词短语命名,并体现类的作用。方法命名采用大小写混合的形式,以小写字母开头,名字中其他单词的首字母以大写字母开头,所有其他的单词都为小写字母,不应使用下划线分隔单词,并且命名应描绘方法的作用和功能。参数与变量的命名同方法的命名相同。

要让代码具有良好的可读性。除了注释和命名外,排版格式对提高可读性也是非常重要的。排版要点是要利用好缩进、空行和空格,让代码结构变得清晰。


代码在线纠错(通义千问 qwen-max)

支持粘贴多个代码文件,提交后由阿里云通义千问自动分析代码漏洞、语法错误、逻辑问题并给出修改建议。
您已解锁 AI 代码纠错功能,可正常使用!

评论区

登录 后发表评论
暂无评论