编码规约(三)代码格式

所有内容摘自阿里巴巴的《Java开发手册-嵩山版》

  1. 【强制】如果是大括号内为空,则简洁的写成 {} 即可,大括号中间无需换行和空格;如果是 非空代码块则:
    1)左大括号前不换行。
    2)左大括号后换行。
    3)右大括号前换行。
    4)右大括号后还有 else 等代码则不换行;表示终止的右大括号后必须换行。

  2. 【强制】左小括号和右边相邻字符之间不出现空格;右小括号和左边相邻字符之间也不出现空格;而左大括号前需要加空格。

  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。

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

  7. 【强制】在进行类型强制转换时,右括号与强制转换值之间不需要任何空格隔开。
    正例:double first = 3.2d;
    int second = (int)first + 2;

  8. 【强制】单行字符数限制不超过 120 个,超出需要换行,换行时遵循以下规则:
    1)第二行相对第一行缩进 4 个空格,从第三行开始,不再继续缩进。
    2)运算符与下文一起换行。
    3)方法调用的点符号与下文一起换行。
    4)方法调用中的多个参数需要换行时,在逗号后换行。
    5)在括号前不要换行。

  9. 【强制】方法参数在定义和传入时,多个参数逗号后面必须加空格。

  10. 【强制】IDE 的 text file encoding 设置为 UTF-8;IDE 中文件的换行符使用 Unix 格式,不要使用 Windows 格式。

  11. 【推荐】单个方法的总行数不超过 80 行。
    说明:除注释之外的方法签名、左右大括号、方法内代码、空行、回车及任何不可见字符的总行数不超过 80行。
    正例:代码逻辑分清红花和绿叶,个性和共性,绿叶逻辑单独出来成为额外方法,使主干代码更加清晰;共性逻辑抽取为共性方法,便于复用和维护。

  12. 【推荐】没有必要增加若干空格来使变量的赋值等号与上一行对应位置的等号对齐。

  13. 【推荐】不同逻辑、不同语义、不同业务的代码之间插入一个空行分隔开来以提升可读性。
    说明:任何情形,没有必要插入多个空行进行隔开。

posted @ 2021-09-06 21:25  超级鲨鱼辣椒  阅读(81)  评论(0编辑  收藏  举报