(第3章)代码风格

岁酱吖の 提交于 2020-03-04 19:41:20

前言:

在团队开发过程中,每个人的代码风格都不一样, 有的人不爱写注释,有的人写注释, 有的人方法与方法之间不爱空一行,非要挤在一起,有的人就写的很规范,像这种千奇百怪的风格会造成什么影响呢? 比如线上有一个紧急bug , 同事去解决这个bug 的时候,他是不是要先看一下你这个代码是怎么样的一个逻辑,其次才能去解决这个问题,当你的代码写的很乱的时候,就会让人这写的像一tuoshi  。

因此团队之间拥有一个比较统一的代码风格很重要,方便维护和提高效率,规范的代码风格总是让人赏析悦目的。

其实小编很早之前就入了这本码出高效Java开发手册,这本书我大概的浏览了一下,书中的内容算是比较生动的,没那么刻板,建议喜欢看书的小伙伴入手一本。

小建议:不管在代码中起什么名字,都切忌中式拼音,如果英语不太好的小伙伴可以下载一个有道词典,因为不管是定义什么类,变量也好,他们的名字都是跟功能相关的。

  • 1.类名采用大驼峰形式,首字母大写。 

 eg:  TestController  StringBuffer

  • 2.变量(参数,成员变量 局部变量),方法名 采用小驼峰形式。  【首字母小写】

eg : sumNumber

  • 3.常量的命名全部大写,多个单词之间用下划线隔开。

常量:

       一般用于描述一个不可变的值,分为全局变量,局部变量,类内变量。  全局变量用public static final 修饰, 类内变量         一般用 private static final 修饰。局部变量分为方法常量和参数常量。

  举例:

    public final static String SEND_MESSAGE = "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={access_token}";
  • 4. 不要到处使用“魔法值”

  举例:

 

方法:1.可以使用Enum枚举类  2,定义一个常量类,在具体的方法,类中调用这些常量。

          在早期的时候我们还可以记得这些魔法值的意义,但是当时间一久,原先的开发人员离职了,你去维护这段代码,你会觉得很痛苦的,相信我。哈哈!

  • 5.代码的缩进,空格 与空行。
  1.     推荐四个空格缩进 ,我一般在idea 上开发的时候,写完代码一般用 ctrl+alt +l  调整一下格式
  2.    定义变量的时候左右要有空格   int i = 100;
  3.    if () {} else {}  括号前后要留有空格,很多地方都要留有空格,我就不一一列举了。
  4.   多个方法,属性可以留有空行,不要挤在一起,举个例子:在定义接口的类里面,其实方法并不是不很多,没必要觉    得多空那么一行会占空间,不空行才会碍眼呢!
  5.   方法行数不应该超过80行,一个个长长的方法一点都不方便整理逻辑,如果你的代码行数超过了80行,要有优化的      空间喔。
  •  6.代码注释

  代码注释非常重要,讲究不宜过多,要写的精简。  修改代码逻辑的时候要同步修改注释,以免造成误会。

  • 7.注释的格式

 提倡使用/** */格式,且这种格式能在idea中配置模板。,非常方便。

 

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!