网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!
Java源文件名区分大小写的,并且首字母大写,以.java扩展名结束。
文件编码
Java源文件编码格式为UTF-8。
特殊字符
-
空格字符:除了行结束符之外,ASCII水平空格字符(0x20)是唯一出现在源文件中任何地方的空格字符。这也意味着,字符串和字符文字中的所有其他空白字符均被转义。制表符不用于缩进。
-
特殊的转义序列:所有转义序列 (\ b, \ t, \ n, \ f, \ r, \ ", \ ’ 和 \\),不是八进制(例如 \ 012)或Unicode(例如 \ u000a)的转义。
-
非ASCII字符:对于其余的非ASCII字符,则使用实际的Unicode字符(例如∞)或等效的Unicode转义符(例如 \ u221e)。用哪种取决于使代码更易于阅读和理解,尽管Unicode会在字符串文字之外进行转义,但是不建议不在注释中使用。例如String unitAbbrev = “μs”,没必要写成String unitAbbrev = “\u03bcs”。
源文件结构
=====
一个Java源文件,按以下顺序组成,并且每个部分空一行分隔开:
-
许可或版权信息(如果有)
-
Package语句,并且不换行的
-
Import语句,最后不要使用通配符导入,无论是静态导入还是其他方式;每一行导入语句都是不换行的;所有静态导入都在一个块中,所有非静态导入也在同一个块中,块之间用一空白行分隔开;在每个块中,导入的名称均按ASCII排序顺序显示。
-
顶级类定义
每一个顶级类都应该在一个单独的源文件中,对于一个类中的内容,最好是有意识地对类中的内容按某种规则排序排版,例如新的方法一般添加在类的尾部,这样我们可以根据时间线索了解这些方法何时加进来的;再比如,当一个类具有多个构造函数或多个具有相同名称的方法时,它们将顺序出现,并且它们之间没有其他代码(甚至没有私有成员)。
格式化
===
前提须知,下文中提及的块状结构是指类的主体,方法或构造函数。
花括号
if,else,for,do,while 等语句块使用花括号,即使花括号内容是空的或者只有一行语句。
对于内容非空的花括号块,遵循以下规则:
-
左括号前不换行
-
左括号后换行
-
右括号前换行
-
右括号后换行,例如方法块,构造函数,类的主体括号情况下才换行。有些整体搭配不换行,例如esle前面的右括号,try块的右括号等。
对于一些空内容地块,以下两种方式都可接受:
void doNothing() {}
void doNothingElse() {
}
缩进
关于一些块结构等的缩进,建议2个空格,并且注释也最好和代码缩进保持一致。
每行一个声明
每个语句后都有一个换行符,不要将多行语句都写在同一行。
列数限制
Java代码的列数限制为100个字符,一个字符是指一个Unicode字符。除非另有说明,否则超出该限制的任何行都必须进行换行。
不过也有一些例外可以超过此限制,例如:
-
Javadoc中的长URL或长的JSNI方法引用
-
package和import语句
-
注释中的命令行,因为可能需要将其拷贝到shell中执行
不要水平对齐
水平对齐是在下一行的代码中添加一些空格,致使与上一行的某个标识符对齐。语法允许这样做,但是不推荐,因为后续可能会再修改代码,可能导致不再对齐,然后再对齐的话需要浪费额外的时间精力。
枚举类
如果一个枚举常量有方法或者注释,在每个枚举常量的逗号后面,最好换一行再定义下一个枚举常量。
如果一个枚举常量没有有方法或者注释,则可以不换行。
private enum Suit { CLUBS, HEARTS, SPADES, DIAMONDS }
变量声明
每个变量声明语句只声明一个变量,不要使用 int a, b;这种多变量的声明。但是for循环的头部中可以接受多个变量声明 。
需要时才声明,不要在代码块的开头就声明局部变量,而是应该在靠近使用局部变量的地方声明它们,以最小化它们的作用域。局部变量应该声明的时候就进行初始化,或者声明后,要立即初始化。
数组
[]方括号应该是类型的一部分,而不是变量,所以应该使用String[] args,而不是 String args[]。
Switch语句
在Switch代码块内,如果一个case小代码块直接穿透到下一个case(例如没有以break,continue,return或者抛异常结尾),则需要在最后一个case后面注释说明原因;最后一定要写default块,即使没有执行任何代码,但是如果switch的是枚举类型,并且case列出所有的枚举值了,可以不用写default。
修饰符
网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!
学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。**
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!