有几个原则如下:
保持原有风格
坚持最小惊奇原则
第一次就做对
记录所有非规范行为
格式规范:
缩进嵌套的代码:在每个代码块和嵌套中加入缩进,缩进代码,加强可读性。这些地方包括【类定义,内部类定义,方法定义,静态块,for循环语句,if-else语句,try、catch和finally块,匿名内部类,while语句,do-while语句】
断开很长的句子:第一,如果包含了逗号,那么在每一个逗号后面都另起一行,把逗号后面的每一个表达式都和逗号前面的表达式的第一个字母对齐。第二,应该在优先级最低的运算符之前断行。
使用空白:关键字和左括号之间,右括号和紧随其后的关键字,除了”.”之外的运算符与其前后的表达式之间用空格隔开。每个逻辑上独立的方法和代码段之间,定义类或者接口的成员之间,每个类和接口之间应该加入空白行。
不要直接使用Tab控制符:不同环境对Tab控制符的解释也是不同的。
命名约定:
名称应该具有实际意义
使用人们熟悉的名称
谨慎使用过长的名字,可以使用简明通用的缩写
尽量保留元音字母
缩写词的第一个字母大写
不要使用大小写来区分的名字
包命名:
用你所在组织的域名的倒序小写形式作为包的根限定词
使用单独的小写词作为每个包的根名
仅当新旧版本二进制兼容的时候,其包可以使用相同的名字,否则,请使用新名字
类型命名:
类和接口名中的每个单词的第一个字母大写
类命名:
用名词命名类
具有成组相关属性,静态服务或者常量的类名字使用复数形式
接口命名:
用名词或者形容词命名接口
方法命名:
方法名中的第一个单词小写,其后每个单词的第一个字母大写
用动词命名方法
遵循JavaBean中命名属性访问函数方法:set,get,is
变量命名:
变量命中的第一个单词小写,其后的每个单词的第一个字母大写
用名词命名变量
集合引用名要用复数形式
为不重要的临时变量简历并使用一套标准名字
字段命名:
使用this字段变量可以区分开局部变量
参数命名:
构造函数或者”set”方法给字段分配参数赋值,参数名应该和字段名相同
常量命名:
常量的每个单词均大写,单词之间使用下划线连接
文档约定:
为使用和维护你的代码的人编写文档
注释和代码要同步
使用积极的语气,省略无用的词语
注释类型:
用文档注释来描述编程接口
用标准注释格式隐藏代码而不必删除它们
用单行注释解释实现细节
文档注释:
在编写代码前描述编程接口
为公用,受保护,包,私有成员建立文档
为每个包编写总结和概述
为包的每个应用程序或组编写概述
注释风格:
对所有文档注释使用统一的格式和组织结构
关键字,标识符和常量应放到…标签中
将代码放入
…
标签中
在标识符第一次出现的时候用{@link}标签
为Javadoc标签简历并使用一套固定的顺序
使用第三人称叙述的形式
编写独立的概述
省略概述中动作和服务的主语
省略事物概述中的对象和动词
使用this而不是the来指代当前类中的实例
方法名或者构造函数名不需圆括号,除非你想突出一个特殊的签名
注释内容:
每个类、接口、字段和方法都编写概述
完整描述每个方法的签名
包含示例
为前置、后置、不变条件编写文档
为已知的缺陷和不足编写文档
为同步语法编写文档
内部注释:
仅添加有助于理解你的代码的内部注释
描写代码为什么这样做,而不是在做什么
避免使用行尾注释
用行尾注释解释局部变量声明
建立并使用一套关键词来标识尚未解决的问题
在嵌套程度高的控制结构中标记出嵌套结束位置
如果两个case标记之间没有break语句,就在中间加入“fall-through”注释
标记空语句
编程约定:
将表示基础数据类型的类声明为final类型
通过本地类型和其他具体类型建立具体类型
定义小的类和小的方法
定义子类,以便任何使用超类的地方都可以使用子类
使所有字段私有
使用多态来替代instanceof
类型安全:
以包装通用类,提供静态类型检查
以类的形式封装枚举类型
尽量使用泛型
语句和表达式:
文章来源:《电脑编程技巧与维护》 网址: http://www.dnbcjqywh.cn/zonghexinwen/2020/0821/396.html
上一篇:C/C++编程笔记:C++入门知识,深入解析C++函数和函
下一篇:【嵌入式】C语言高级编程——嵌入式C语言入门编
电脑编程技巧与维护投稿 | 电脑编程技巧与维护编辑部| 电脑编程技巧与维护版面费 | 电脑编程技巧与维护论文发表 | 电脑编程技巧与维护最新目录
Copyright © 2018 《电脑编程技巧与维护》杂志社 版权所有
投稿电话: 投稿邮箱: