阿里是这样要求 JAVA 程序员的，你们都知道么？

2016年底，阿里巴巴公开了其在内部使用的JAVA编程规范。随后进行了几次版本修订，笔者当时看到的版本为v1.0.2版。下载地址可以在其官方社区—— 云栖社区 找到。

笔者作为一名有数年工作经验的Java程序员，仔细研读了这份手册，觉得是一份不可多得的好材料。正如阿里巴巴在发布时所说，“阿里巴巴集团推出的《阿里巴巴Java开发手册（正式版）》是公司近万名开发同学集体智慧的结晶，以开发视角为中心，详细列举了如何开发更加高效、更加容错、更加有协作性，力求知其然，更知其不然。结合正反例，让Java开发者能够提升协作效率、提高代码质量。” 同时，阿里巴巴也期望这套Java统一规范标准将有助于提高行业编码规范化水平，帮助行业人员提高开发质量和效率、大大降低代码维护成本。

其实早在多年前，google就已经把公司内部采用的所有语言的编码规范(其称为 Style Guide )都开源在Github上。这份清单中包括了 C++ 、 Objective-C 、 Java 、 Python 、 R 、 Shell 、 html/css 、 JavaScript 、 AngularJS 、 Common Lisp 、 Vimscript 等语言的编程规范。并且Google还发布了一个用于检查样式合规性的工具 cpplint 以及在Emacs中使用Google编程样式的配置文件 google-c-style.el 。看来Google中Emacs粉比Vim粉要强势的多。

Google为什么要发布这样的Style Guide呢？因为它认为几乎所有的开源项目都需要有一组约定来规范如何编写代码。如果项目中的代码都能保持一致的风格，那么即使代码再多也会很容易的被人理解。

Google的这份编程规范包含了很多方面，从”对变量使用camelCase命名法”到”绝不要使用全局变量”到”绝不允许例外“等。其Java编程规范包含7大部分，分别为介绍、源文件基本要求、源文件结构、格式化、命名、编程实践和Javadoc。每一部分又细分为很多子条目。如果采取条规范的原因不是很容易理解，都会配有相应的示例或者引用文章。

由于Google的这份编程规范目前只有英文版本，所以在中国的程序员中只有少部分人知道它的存在。并且只有更少的团队在真正的应用它，其中就包括我的团队。我们团队根据Google的 Java style guide 也演化出了自己的团队版本，放置在团队共享wiki上供大家随时查阅。我们根据自身的项目特点丰富了”编程实践”里的内容，并且新加入一个章节来描述编写Java代码的一些原则，比如简洁代码、组合优于继承、stream优于for循环等。

我想阿里巴巴发布的Java开发手册之所以叫做”开发手册”，而不是像Google那样叫做“Style Guide(样式风格)”，是因为它不仅仅局限于style guide这一方面，而是以Java开发者为中心视角，划分为编程规约、异常日志规约、MySQL规约、工程规约、安全规约五大块，再根据内容特征，细分成若干二级子目录。根据约束力强弱和故障敏感性，规约依次分为强制、推荐、参考三大类。

该开发手册中的每一条都值得了解。限于篇幅原因，这里只列出”编程规约“中有感受的几条来评述一下。

 

命名规约的第15条描述了在Service/DAO层对于资源的操作的命名规范。这一条的参考价值极大，因为我所有待过的团队对于这一点都没有明显的约束，每个团队都有五花八门的实现。如果能遵守这一点，那么我们在操作资源时就会减少一些困扰。

 

这是常量定义的第2条。从这一点可以看出阿里巴巴对代码可读性的细节扣的很严格。我也很赞同这一点。代码只需编写一次，而会被查看无数次，所以要力争在第一次编写的时候尽可能少的引入歧义。

 

格式规约的第1条终于终结了括号之争。这一条需要强制遵守，那么左大括号换行一派则被彻底排除在阿里巴巴之外。有人说不推荐左大括号换行，可以减少行数，增加单个屏幕可以显示的代码行数。而有的人反驳说现在屏幕已经足够大，不换行则破坏了对称之美。其实对于我来说两种格式都有各自的好处，我都可以接受，只要团队能够坚持使用其中之一即可。

 

使用空格代替tab字符进行缩进已经成为了编程界的共识。其主要原因是不同的平台甚至不同的编辑器下tab字符的长短是不一样的。不过Google在其《java style guide》中规定缩进为2个空格，而阿里巴巴约定为4个空格。由于4个空格的缩进比2个空格的缩进长一倍，所以如果在代码嵌套过深的情况下可能会很快超过单行最多字符数(阿里巴巴规定为120个)的限制。不过这个问题可以从另一个方面进行思考，如果由于缩进的原因导致单行字符数超标，这很可能是代码设计上有坏味道而导致嵌套过深。所以最好从调整代码结构的方面下手。

 

 

关于换行，Google并没有给出明确的要求，而阿里巴巴则给出了强制性的要求。Google特别提示可以通过一些重构手法来减少单行字符长度从而避免换行，这一点我颇为认同。关于参数，很多方法调用超过120个字符需要换行，这暴露除了过长参数列的代码坏味道，解决方式之一就是使用重构手法的Replace Parameter With Method的方式把一次方法调用化为多次方法调用，或者使用Introduce Parameter Object手法创造出参数对象并进行传递。

 

这是《Effective Java》以及其他文章中经常提及的优化方式，而且面试初级Java工程师时几乎是一个必考点。其实不仅是在循环体内，所有需要进行多次字符串拼接的地方都应该使用StringBuilder对象。

 

这其实就是经典的原则‘Principle of least privilege’ 的体现。我们必须遵循这一原则，但不知为何阿里巴巴将其级别列为“推荐”。

 

编写代码时，对参数进行校验是不可避免的。详细说又扯到“防御式编程”和“契约式编程”的话题上。这两项之所以列为参考，并没有强迫大家遵守。

 

看到这一条我已经笑出来了。这一条说的很好，注释是用来阐述问题的，如果看了注释还一头雾水，那么这样的注释不要也罢。使用中文没什么可丢人的，解决问题才是王道。

 

阿里巴巴对该条的说明非常到位。其实我们团队在编写代码时默认是没有任何注释的，因为我们追求的是self-explanatory methods。即代码本身已经就能说明它的用途。只有在很少的情况下需要添加注释。

编程规约的第九部分都是很好的tips，值得去了解和学习。

除了编程规约之外，日志规约、MySQL规约、工程规约和安全规约也都有极高的参考价值，这也是比Google的Java Style Guide出色的地方。这里就不再评述了。

阿里巴巴公布这个Java开发手册绝对是值得赞赏的事情。最后我也想给其提几点建议：

建议使用公开wiki的方式发布该手册，而不是采用pdf的方式。因为如果像google那样是公开wiki方式的话，可以方便大家参与修正和改进，并且可以看到版本历史。

该手册并没有明确的版权许可，只是在页脚处加入了“禁止用于商业用途，违者必究”的字样。Google的style guide的版权为CC-By 3.0 License，建议阿里巴巴能够指明其版权。

手册中的部分示例代码并没有遵守其列出的编程规约，有点打脸之嫌。比如以下示例代码：

Iterator<String> it = a.iterator();

while(it.hasNext()){

String temp = it.next();

if(删除元素的条件){

it.remove();

}

}

其while和if关键字与小括号之间并没有空格，违反了该手册中3. 【强制】if/for/while/switch/do 等保留字与左右括号之间都必须加空格。这一规则。

集合处理中可以多推荐一些Java8的集合操作方法。

有些名词没有过多解释，比如很多人可能都不知道什么叫一方库、二方库。

希望除了这份开发手册以外，阿里巴巴也可以推出对应的checkstyle配置文件以及Intellij、Eclipse的配置文件。毕竟格式化这些事都可以交由IDE来解决，通过在构建时使用checkstyle插件也可以防止不合规的代码迁入到仓库，从源头上保证代码样式的一致性。

最后，希望这份Java开发手册可以持续改进，吸纳百家之长，成为每个入门程序员必看的手册。

原文链接:https://www.toutiao.com/i6459605525188313614/

喜欢对你有帮助的话记得加个关注不迷路哦

还有关注我私信回复【资料】可以领取到一些个人收集的面试及电子书资料，或许对你有帮助！