下载《阿里巴巴Java开发手册（详尽版）1.4.0》

地址：

https://yq.aliyun.com/download/2720?utm_content=m_1000019584

《阿里巴巴Java开发手册》是阿里内部Java工程师所遵循的开发规范，涵盖编程规约、单元测试规约、异常日志规约、MySQL规约、工程规约、安全规约等，这是近万名阿里Java技术精英的经验总结，并经历了多次大规模一线实战检验及完善。这是阿里回馈给Java社区的一份礼物，希望能够帮助企业开发团队在Java开发上更高效、容错、有协作性，提高代码质量，降低项目维护成本。

码出高效，码出质量！

相比C++代码规范业界已经达成共识，Java代码规范业界比较混乱，我们期待这次发布的Java代码规范能够给业界带来一个标准，促使整体行业代码规范水平得到提高，最终能够帮助企业和开发者提升代码质量和降低代码故障率。

阿里出品，质量保证！

阿里Java技术团队一手打造出Dubbo、JStorm、Fastjson等诸多流行开源框架，部分已成为Apache基金会孵化项目；

阿里在Java后端领域支撑起全球访问量最大的服务器集群；

Java代码构建的阿里双11业务系统订单处理能力达到54.4万笔/秒（2019年）；链接可查看

通过在阿里云公共云上运行阿里核心系统，每秒创建54.4万个采购订单，支付宝网购支付的最高峰值达到了每秒6100万次。链接可查看

到目前已累计数十亿行高并发、高稳定性的最佳Java代码实践；

……

此次公开的Java开发手册正是出自这样的团队，近万名阿里Java技术精英的经验总结，并经历了多次大规模一线实战检验及完善，铸就了这本高含金量的阿里Java开发手册。该手册以Java开发者为中心视角，划分为编程规约、异常日志规约、MYSQL规约、工程规约、安全规约五大块，再根据内容特征，细分成若干二级子目录。根据约束力强弱和故障敏感性，规约依次分为强制、推荐、参考三大类。此套规范不仅能让代码一目了然，更有助于加强团队分工与合作、真正提升效率。

无规矩不成方圆无规范不能协作

众所周知，制订交通法规表面上是要限制行车权，实际上是保障公众的人身安全。试想如果没有限速，没有红绿灯，没有规定靠右行驶，谁还敢上路行驶。

同理，对软件来说，适当的规范和标准绝不是消灭代码内容的创造性、优雅性，而是限制过度个性化，以一种普遍认可的方式一起做事，降低故障率，提升协作效率。开发手册详细列举如何开发更加高效，更加容错，更加有协作性，力求知其然，更知其不然，结合正反例，提高代码质量。比如，异常日志处理时的各种不规范行为；集合转换的各种坑；创建线程池出现的等待队列OOM等。

阿里技术资深大咖联袂推荐

阿里高级研究员多隆：工程师对于代码，一定要“精益求精”，不论从性能，还是简洁优雅，都要具备“精益求精”的工匠精神，认真打磨自己的作品。

阿里研究员毕玄：一个优秀的工程师和一个普通工程师的区别，不是现在满天飞的架构图，他的功底就是体现在他写的每一行代码上。

阿里研究员玄难：代码是软件工程里面的产品设计、系统架构设计等工作的最后承载体，代码的质量决定了一切工作的成败。

阿里巴巴B2B事业群CTO李纯：好的软件产品离不开工程师高质量的代码及相互间顺畅的沟通与合作。简单，适用的代码规约背后所传递的是技术上的追求卓越、协同合作的精神，是每个技术团队不可缺失的重要利器。

阿里研究员、HipHop作者：赵海平（花名：福贝）：程序员是创造个性化作品的艺术家，但同时也是需要团队合作的工种。个性化应尽量表现在代码效率和算法方面，牺牲小我，成就大我。

拥抱规范，远离伤害！

团队开发，是互相伤害？还是互相进步！是项目抱怨？还是项目进度！

代码的可读性是指代码让人容易阅读、理解、调试、可预料的程度。提高代码的可读性可以为代码阅读者节约时间和精力，提升团队协作效率。熟悉和遵守《阿里巴巴Java开发手册》的编程风格，那只是“标”，而代码可读性的“本”可以追溯到软件设计阶段。根据阿里巴巴内部的反馈声音来看，对于数据底层结构、状态图、以及敏捷开发相关的三条，共鸣感最强，那么详细点评一下。

1. 数据底层结构

底层数据结构属于大厦的地基工程，如果地基不稳，那么上层去修正难度是相当大的，甚至是无法修正。所以设计规约提倡，存储方案和底层数据结构的设计获得评审一致通过，并沉淀成为文档。有缺陷的底层数据结构容易导致系统风险高，可扩展性差，重构成本因历史数据迁移、系统平滑过渡也会陡然增加，所以，存储方案和数据结构需要认真地进行设计和评审，生产环境提交执行后，需要进行double check。评审内容包括存储介质选型、表结构设计能否满足技术方案、存取性能和存储空间能否满足业务发展、表或字段之间的辩证关系、字段名称、字段类型、索引等；数据结构变更（如在原有表中新增字段）也需要进行评审通过后上线。

2. 状态图

业务对象状态相关的编码错误是引起线上故障的一个重要导火索。多一个状态，少一个状态，如果没有历史设计文档沉淀，那么都是灾难性的。如果某个业务对象的状态超过3个，使用状态图来表达并且明确状态变化的各个触发条件。状态图的核心是对象状态，首先明确对象有多少种状态，然后明确两两状态之间是否存在直接转换关系，再明确触发状态转换的条件是什么。淘宝订单状态有已下单、待付款、已付款、待发货、已发货、已收货等。比如已下单与已收货这两种状态之间是不可能有直接转换关系的。

3. 敏捷开发

敏捷开发是当下流行的一种开发模式，相比传统软件生产流程，更加快速地交付。但是，敏捷开发适合于信任度好、理解力强、技术水平相对一致的创业型团队。但是在很多公司敏捷成为一个抓进度的拔苗助长式的借口。所以避免如下误解：敏捷开发 = 讲故事 + 编码 + 发布。敏捷开发是快速交付迭代可用的系统，省略多余的设计方案，摒弃传统的审批流程，但核心关键点上的必要设计和文档沉淀是需要的。

对应的IDE插件

Eclipse 安装阿里P3C插件

Help >> Install New Software>> Add... 插件安装菜单，在安装插件的地址栏中输入：https://p3c.alibaba.com/plugin/eclipse/update

确定后，直接勾选下面的Smartfox Eclipse Plugnin，然后一直下一步安装（中间需要点“I Accept”）

安装完成后需重启eclipse，重启完成后，我们可以看到eclipse任务栏中多了两个小图标

当我们安装完成后，右键菜单中会出现“阿里编码规约扫描”

IDEA，选择Preferences - Plugins - Browse repositories后，在输入框中输入"alibaba"，可以看到返回结果中有"Alibaba Java Coding Guidelines"。点击插件详情中的"install"按钮，按照其提示即可完成安装，安装完成后需重启IDEA。