送你最新版Java开发手册

相信写Java的同学应该都听过阿里巴巴的《Java开发手册》吧？里面有很多关于代码格式，代码规约的正例、反例，简直就是居家旅行必备的手册。

这本开发手册不仅包含了代码级的规约，甚至还包括了设计、工程结构、数据库等等的规约，推荐每一位Java工程师都要通读一遍。

而最近这本手册又更新了黄山版，今天我们就来梳理一下各个版本的改动。

如果想要这本手册的各个版本汇总全集，可以关注下方公众号SpringForAll社区，回复关键词【开发手册】，就能免费获取！

正式版 2017.02.09

阿里巴巴集团正式对外发布

完美版 2017.05.20

1）根据云栖社区的“聚能聊”活动反馈，对手册的页码、排版、描述进行修正。

2）增加 final 的适用场景描述。

3）增加关于锁的粒度的说明。

4）增加“指定集合大小”的详细说明以及正反例。

5）增加卫语句的示例代码。

6）明确数据库表示删除概念的字段名为 is_deleted

纪念版 2017.11.30

修正部分描述；采用和 P3C 开源 IDE 检测插件相同的 Apache2.0 协议。

详尽版 2018.05.20

增加设计规约大类，共 16 条。

华山版 2019.06.19

1）鉴于本手册是社区开发者集体智慧的结晶，本版本移除阿里巴巴 Java 开发手册的限定词“阿里巴巴”。

2）新增 21 条新规约。比如，switch 的 NPE 问题、浮点数的比较、无泛型限制、锁的使用方式、判断表达式、日期格式等。

3）修改描述 112 处。比如，IFNULL 的判断、集合的 toArray、日志处理等。

4）完善若干处示例。比如，命名示例、卫语句示例、enum 示例、finally 的 return示例等。

泰山版 2020.04.22

1）发布错误码统一解决方案，详细参考附表 3**。** 

2）新增 34 条新规约。比如，日期时间的闰年、闰月问题，三目运算的自动拆箱，SQL查询的表别名限定，Collectors 类的 toMap()方法使用注意等。 

3）修改描述 90 处。比如，阻塞等待锁、建表的小数类型等。 

4）完善若干处示例。比如，ISNULL 的示例等。

嵩山版 2020.08.03

1）新增前后端规约 14 条。 

2）新增禁止任何歧视性用语的约定。 

3）新增涉及敏感操作的情况下日志需要保存六个月的约定。 

4）修正 BigDecimal 类中关于 compareTo 和 equals 的等值比较。

5）修正 HashMap 关于 1024 个元素扩容的次数。

6）修正架构分层规范与相关说明。

7）修正泰山版中部分格式错误和描述错误。

黄山版 2022.02.03

1）新增11条新规约。比如，浮点数的后缀统一为大写；枚举的属性字段必须是私有且不可变；配置文件中的密码需要加密等。

2）新增描述中的正反例2条。比如，多个构造方法次序、NoSuchMethodError处理；新增拓展说明5条。比如，父集合元素的增加或删除异常等。

3）修改描述22处。比如，父集合元素的增加或删除异常等。

4）修正嵩山版中部分代码格式错误和描述错误。

关注下方公众号SpringForAll社区，

回复关键词【开发手册】，

就能免费获取开发手册合集！

（已包含最新黄山版）