代码格式规约
(三) 代码格式
1.【强制】 如果大括号内为空,简洁地写成 {} 即可;如果是非空代码块,则: 1)左大括号前不换行。 2)左大括号后换行。 3)右大括号前换行。 4)右大括号后还有 else 等代码则不换行;表示终止的右大括号后必须换行。
2.【强制】 左小括号和右边相邻字符之间不需要空格;右小括号和左边相邻字符之间也不需要空格;而左大括号前需要加空格。 反例:if(空格 a == b空格)
3.【强制】 if / for / while / switch / do 等保留字与左右括号之间都必须加空格。
4.【强制】 任何二目、三目运算符的左右两边都需要加一个空格。 说明:包括赋值运算符 =、逻辑运算符 &&、加减乘除符号等。
5.【强制】 采用 4 个空格缩进,禁止使用 Tab 字符。 说明:如使用 Tab 缩进,必须设置 1 个 Tab 为 4 个空格。
6.【强制】 注释的双斜线与注释内容之间有且仅有一个空格。 正例:// 这是示例注释,请注意在双斜线之后有一个空格
7.【强制】 在进行类型强制转换时,右括号与强制转换值之间不需要任何空格隔开。 正例:double first = 3.2D; int second = (int)first + 2;
8.【强制】 单行字符数限制不超过 120 个,超出需要换行,换行时遵循如下原则: 1)第二行相对第一行缩进 4 个空格,从第三行开始,不再继续缩进。 2)运算符与下文一起换行。 3)方法调用的点符号与下文一起换行。 4)方法调用中的多个参数需要换行时,在逗号后进行。 5)在括号前不要换行。
9.【强制】 方法参数在定义和传入时,多个参数逗号后面必须加空格。 正例:method(args1, args2, args3);
10.【强制】 IDE 的 text file encoding 设置为 UTF-8;IDE 中文件的换行符使用 Unix 格式,不要使用 Windows 格式。
11.【推荐】 单个方法的总行数不超过 80 行。 说明:除注释之外的方法签名、左右大括号、方法内代码、空行、回车及任何不可见字符的总行数不超过 80 行。
12.【推荐】 没有必要增加若干空格来使变量的赋值等号与上一行对应位置的等号对齐。
13.【推荐】 不同逻辑、不同语义、不同业务的代码之间插入一个空行,分隔开来以提升可读性。 说明:任何情形,没有必要插入多个空行进行隔开。