JAVA代码规范笔记（下）

Posted 2020-09-19 cxchanpin

声明

17、推荐一行一个声明。由于这样有利于写凝视。

换句话说。以下的声明方法中，

int level; // indentation level
int size; // size of table

要优于：

int level, size;

绝对不要将变量和方法的声明放在同一行，比如：

long dbaddr, getDbaddr(); // WRONG!

不要将不同类型的变量的声明放在同一行，比如：

int foo, fooarray[]; //WRONG!

注意：上面的样例中。变量与标识符之间仅仅用了一个空格。还有一种被接受的方式是使用制表符，如：

int level;		// indentation level
int size;		// size of table
Object currentEntry; 	// currently selected table entry

18、仅仅把声明放在代码块的开头处。

（一个代码块是指被包括在“{”和“}”之间的代码。）不要等到它们第一次用的时候才去声明变量。这会指没注意力到的程序猿搞糊涂，同一时候也会妨碍到代码在该作用域内的移植性。

void MyMethod() {
    int int1; // beginning of method block
    if (condition) {
        int int2; // beginning of "if" block
        ...
    }
}

这条规则的唯一例外是 for 循环里的索引变量，它在Java代码中能声明在 for 语句里面。

for (int i = 0; i < maxLoops; i++) { ...

19、避免声明的局部变量覆盖了上一级别声明的变量。

比如，不要在内部代码块中声明同样的变量名。

int count;
...
func() {
    if (condition) {
        int count; // 应避免!
        ...
    }
    ...
}

20、尽量在声明局部变量的同一时候初始化。唯一不这么做的理由是变量的初始值首先依赖于某些发生的计算。

21、当编写类和接口时，应遵循下面格式规则：

• 在方法名与參数列表的左括号“(”之间不要有空格
• 左大括号“{”位于声明语句同一行的结尾
• 右大括号“}”另起一行，与相应的声明语句对齐。除非是一个空语句，这时“}”应紧跟在“{”之后。

class Sample extends Object {
    int ivar1;
    int ivar2;

    Sample(int i, int j) {
        ivar1 = i;
        ivar2 = j;
    }

    int emptyMethod() {}

    ...
}

• 方法之间用空行隔开

语句

22、每一行最多包括一条语句。

如：

argv++; argc--; // 应避免!

23、除非是有明显的理由，否则不要用逗号来组合多条语句。如：

if (err) {
    Format.print(System.out, “error”), exit(1); //严重错误<span style="font-family: Arial, Helvetica, sans-serif;">!</span>
}