本文旨在用最通俗的语言讲述最枯燥的基本知识

1

到一家创业公司上班的第一天，老员工刘XX给我看了公司他负责的项目，奇怪的是，命名是“LiuQXProject”，刘XX看着惊愕的我说：“怎么了？有什么错吗？”

2

给同事做双十一活动相关代码的review，学到到了很多中英混血单词
，获取双十一拼团活动数据的接口叫做“get_ShuangShiYi_GroupTuan_activity_data”，特等奖的命名：TeDeng_price....更气人的是，我们活动奖等有十级，他就虔诚地继续OneDeng_price、TwoDeng_price
直到JiuDeng_price。。。噢，no！！好气啊！！而且他还把”奖“的单词prize写成了price，怎么说呢？好难受..

3

公司来了个刚毕业的小伙子，自诩前端未来之星，喜欢研读源码，对开源充满热爱，一个月后，无意间打开他写的一个js文件，让我惊讶的是：变量从a到z全部用完，更气人的是，26个字母用完之后，他竟然丧心病狂的用起来了双拼，var aa=1，var ab=“12”，var ac=null...我问他为什么这样命名，他说你没研读jQuery源码吗？人家就是这样做的，简洁大气上档次！

4

因为微信昵称经常有带有一些乱七八糟的表情或者字符，在正常情况下utf-8编码的数据库是存不进去的，因此让同事帮忙写个把微信昵称转换成正常的字符串的一个工具函数，最终我拿到了这个工具函数，名字叫做：convertingWechatNicknameintoNormalCharacters(String nickName)

5

实习小伙子来的头一天就搞的满身大汗，我说怎么了，他说我明明写了main方法，为什么运行不了，我一看代码，我噻~main写成了mian，怎么可能跑得起来啊！更残暴的是：苹果手机是apple_sj，Android手机是android_sj，哈哈~

以上的种种让人哭笑不得的命名问题..相信很多小伙伴也会碰过这样，有些是因为经验不足，有些是因为一直没有对自己写的代码做一些规范化的工作，有的是因为被老项目、前辈带出来的坏习惯...这些都是编程世界里非常不好的行为，拒不完全统计：在一个项目中，程序员80%的时间都是在和变量、函数、方法打交道，因此一个好的命名习惯，比注释或一份详细的开发文档都重要。针对于此，小编特意根据行业标准---阿里开发文档，做了一些参考和摘抄，整理出一份关于命名方面的规范，给需要的你作参考。

争取多写漂亮代码，少写注释！！！

文章提纲：

整体规范

包规范

类规范

方法规范

OOP的一些强制规范

1. 整体规范

所有的命名必须以英文意译，不能以中文拼音意译，如：获取我的消息接口，可以写：myMessage；但不能写：myXiaoXi

尽量用精简的英文命名，但要完整表达其意义，杜绝int a ,int a1 int aa这种毫无意义的简化写法。

所有命名不能以特殊符号开始，如：_age,_username

常量用全大写定义，单词之间用下划线分割语义，如：public final int REDIS_MAX_IDLE=5;

2. 包规范

包名全小写，不能用特殊符号或者驼峰写法如：com.courseLog.uitl_con是不合规范的。

包名要符合包的作用，比如数据层要写dao,工具包要写util等

3. 类规范

类名风格为大写开头的驼峰命名方式，如：ApiController、TestController等

异常类命名使用Exception结尾，如：CustomerException

抽象类命名使用Abstract开头，如：AbstractCustomer

测试类命名以它要测试的类的名称开始,以 Test 结尾,如：CustomerControllerTest

枚举类命名要以Enum结尾，如果CustomerRoleEnum

其它类型的类命名，在描述类作用的同时，也尽可能表达出类所用的一些设计模式

4. 方法规范

方法名使用驼峰写法，以小写字母开头，如：getUserCourse();

方法内的参数名、成员变量、局部变量均使用驼峰写法，以小写字母开头，如：int userName;

接口类的方法和属性不要加上任何修饰符，保证代码的简介。

方法定义必须要有注释，包括（方法作用、参数名、返回类型、创建时间等）

Service/DAO层方法命名规约:
> 1) 获取单个对象的方法用get做前缀。
> 2) 获取多个对象的方法用list做前缀。
> 3) 获取统计值的方法用count做前缀。
> 4) 插入的方法用save/insert做前缀。
> 5) 删除的方法用remove/delete做前缀。
> 6) 修改的方法用update做前缀。

5. OOP的一些强制规范

尽量避免使用可变参数编程，相同参数类型,相同业务含义,才可以使用 Java 的可变参数,避免使用 Object

接口过时必须加@Deprecated 注解

不能使用过时的类或方法

所有的相同类型的包装类对象之间值的比较,全部使用 equals 方法比较

类内方法定义顺序依次是:公有方法或保护方法 > 私有方法 > getter/setter 方法。

觉得本文对你有帮助？请分享给更多人
关注「编程×××」，提升装逼技能
<br>

那些让程序员崩溃又想笑的程序命名...相关推荐

北京python程序员求职_想找python程序员的工作，但发现稍微好点的职位都集中在北京。我非常想当python程序员，北京值得去吗？...
想当Python程序员,北京值得去吗?你也知道北京的人口多.环境污染很严重,房价也高得离谱,交通拥挤.但每天照样有无数人从外地往北京跑,也有无数人从北京离开.所以,还是先来看看去北上广深一类大城市工作 ...
程序员崩溃的 40 个瞬间!!! 太形象了
程序员的成长之路互联网/程序员/成长/职场关注阅读本文大概需要 2.8 分钟. 来自知乎专栏互联网视界编辑:可可 https://zhuanlan.zhihu.com/p/4706652 ...
程序员糗事--爆笑中====
程序员糗事--爆笑中==== 似乎任何职业都会给从业人员带来这样那样的习惯.国外某网站上有位朋友(应该也是程序员)想了解其他程序员在投身堆码事业后有什么样的坏习惯.结果一呼百应,很多程序员纷纷自爆自己 ...
程序员崩溃的40多个瞬间！！！太形象了，你遇到过几个？
本文转载自进击的coder,特此感谢! 说到程序员,在外界眼里,他们是掌控代码的大神,他们是改变世界的王者.其实程序员的工作不容易,不信,就来看看程序员崩溃的各种瞬间--(前方高能) 01 公司实习生 ...
程序员崩溃的40个瞬间！（动图）
点击上方"大鱼机器人",选择"置顶/星标公众号" 福利干货,第一时间送达! 阅读本文大概需要 5 分钟. 说到程序员,在外界眼里,他们是掌控代码的大神,他们是改 ...
程序员崩溃的40个瞬间！！！
全世界只有3.14 % 的人关注了爆炸吧知识说到程序员,在外界眼里,他们是掌控代码的大神,他们是改变世界的王者.其实程序员的工作不容易,不信,就来看看程序员崩溃的各种瞬间-- 01 公司实习生找b ...
小程序 delete_程序员崩溃的43个瞬间！搞工科的是不是都这样？
说到程序员,在外界眼里,他们是掌控代码的大神,他们是改变世界的王者.其实程序员的工作不容易,不信,就来看看程序员崩溃的各种瞬间-- 01 公司实习生找bug 02 在调试时,将断点设置在错误的位置 0 ...
vscode 崩溃_太真实了！程序员崩溃的40个瞬间
点击上方 "数据科学杂谈"关注公众号和我一起提升然后点击右上角三个点,设为"星标",即使获取更多知识说到程序员,在外界眼里,他们是掌控代码的大神,他们是改变 ...
疯了！程序员崩溃的40个瞬间！！！
说到程序员,在外界眼里,他们是掌控代码的大神,他们是改变世界的王者.其实程序员的工作不容易,不信,就来看看程序员崩溃的各种瞬间-- 01 公司实习生找bug 02 在调试时,将断点设置在错误的位置 0 ...

那些让程序员崩溃又想笑的程序命名...

1

2

3

4

5