软件开发

当前位置:首页 > 软件开发

阿里Java开发手册(续)


(三) 代码格式 

1. 【强制】如果是大括号内为空,则简洁地写成{}即可,大括号中间无需换行和空格;如果是非 空代码块则:

1) 左大括号前不换行。

2) 左大括号后换行。 

3) 右大括号前换行。

4) 右大括号后还有 else 等代码则不换行;表示终止的右大括号后必须换行。

2. 【强制】左小括号和右边相邻字符之间不出现空格右小括号和左边相邻字符之间也不出现空 格;而左大括号前需要加空格。详见第 5 条下方正例提示。

反例:if (空格 a == b 空格) 

3. 【强制】if/for/while/switch/do 等保留字与括号之间都必须加空格。

4. 【强制】任何二目、三目运算符的左右两边都需要加一个空格。 

说明:包括赋值运算符=、逻辑运算符&&、加减乘除符号等。

5. 【强制】采用 4 个空格缩进,禁止使用 Tab 字符。 

说明:如果使用 Tab 缩进,必须设置 1 个 Tab 为 4 个空格。IDEA 设置 Tab 为 4 个空格时,请勿勾选 Use  tab character;而在 Eclipse 中,必须勾选 insert spaces for tabs

正例: (涉及 1-5 点)

public static void 
main
(
String
[] 
args
) { 
 
// 缩进 4 个空格 
 String say 
= 
"hello"
; 
 
// 运算符的左右必须有一个空格 
 
int 
flag 
= 
0
; 
 
// 关键词 if 与括号之间必须有一个空格,括号内的 f 与左括号,0 与右括号不需要空格 
 
if 
(
flag 
== 
0
) { 
 System
.
out
.
println
(
say
); 
 
} 
 
// 左大括号前加空格且不换行;左大括号后换行 
 
if 
(
flag 
== 
1
) { 
 System
.
out
.
println
(
"world"
); 
 
// 右大括号前换行,右大括号后有 else,不用换行 
 
} 
else 
{ 
 System
.
out
.
println
(
"ok"
); 
 
// 在右大括号后直接结束,则必须换行 
 
} 
}

6. 【强制】注释的双斜线与注释内容之间有且仅有一个空格。 

正例:

// 这是示例注释,请注意在双斜线之后有一个空格 
String commentString 
= 
new 
String
();

 

7. 【强制】在进行类型强制转换时,右括号与强制转换值之间不需要任何空格隔开。

正例:

double 
first 
= 
3.2d
; 
int 
second 
= 
(
int
)
first 
+ 
2
;


8. 【强制】单行字符数限制不超过 120 个,超出需要换行,换行时遵循如下原则:

1)第二行相对第一行缩进 4 个空格,从第三行开始,不再继续缩进,参考示例。

2)运算符与下文一起换行。

3)方法调用的点符号与下文一起换行。

4)方法调用中的多个参数需要换行时,在逗号后进行。

5)在括号前不要换行,见反例正例: 

StringBuilder sb 
= 
new 
StringBuilder
(); 
// 超过 120 个字符的情况下,换行缩进 4 个空格,并且方法前的点号一起换行 
sb
.
append
(
"yang"
).
append
(
"hao"
)... 
 
.
append
(
"chen"
)... 
 
.
append
(
"chen"
)... 
 
.
append
(
"chen"
); 
反例: 
StringBuilder sb 
= 
new 
StringBuilder
(); 
// 超过 120 个字符的情况下,不要在括号前换行 
sb
.
append
(
"you"
).
append
(
"are"
)...
append 
 
(
"lucky"
); 
// 参数很多的方法调用可能超过 120 个字符,逗号后才是换行处 
method
(
args1
, 
args2
, 
args3
, ... 
 
, 
argsX
);


相关内容

文章评论

表情

共 0 条评论,查看全部
  • 这篇文章还没有收到评论,赶紧来抢沙发吧~