阿里技术结晶：《阿里巴巴Java开发手册-v1.7.0-嵩山版》[附件下载]

JackJiang · 4 年前

【语录】：“别人都说我们是码农，但我们知道，自己是个艺术家。也许我们不过多在意自己的外表和穿着，但我们不羁的外表下，骨子里追求着代码的美、质量的美。而代码规约其实就是一个对美的定义。”

1、前言

最新动态：阿里巴巴技术团队于2020年08月03日发布v1.7.0（嵩山版）！

2017年开春之际，阿里诚意献上重磅大礼：《阿里巴巴Java开发手册(规约)》，首次公开阿里官方Java代码规范标准。这套Java统一规范标准将有助于提高行业编码规范化水平，帮助行业人员提高开发质量和效率、大大降低代码维护成本。

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

另外，《作者谈《阿里巴巴Java开发手册(规约)》背后的故事》一文，可以看看作者怎么说。

下载方式：手册下载请见文末“8、最新手册附件下载”！

2、价值意义

《阿里巴巴Java开发手册(规约)》的愿景是码出高效，码出质量。它结合作者的开发经验和架构历程，提炼阿里巴巴集团技术团队的集体编程经验和软件设计智慧，浓缩成为立体的编程规范和最佳实践。众所周知，现代软件行业的高速发展对开发者的综合素质要求越来越高，因为不仅是编程相关的知识点，其他维度的知识点也会影响软件的最终交付质量，比如，数据库的表结构和索引设计缺陷可能带来软件的架构缺陷或性能风险；单元测试的失位导致集成测试困难；没有鉴权的漏洞代码易被黑客攻击等。所以，本手册以开发者为中心视角，划分为编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约七个维度，每个条目下有相应的扩展解释和说明，正例和反例，全面、立体、形象地帮助到开发者的成长和团队代码规约文化的形成。

从严格意义上讲，《阿里巴巴Java开发手册(规约)》超越了Java语言本身，明确作为一名合格开发者应该具备的基本素质，因此本手册适合计算机相关行业的管理者和研发人员、高等院校的计算机专业师生、求职者等阅读，希望成为大家如良师益友般的工作手册、工具字典。

3、最新动态

▶ 关于嵩山版（v1.7.0）：

1）新增前后端规约 14 条。
2）新增禁止任何歧视性用语的约定。
3）新增涉及敏感操作的情况下日志需要保存六个月的约定。
4）修正 BigDecimal 类中关于 compareTo 和 equals 的等值比较。
5）修正 HashMap 关于 1024 个元素扩容的次数。
6）修正架构分层规范与相关说明。
7）修正泰山版中部分格式错误和描述错误。

▶ 关于泰山版（v1.6.0）：
此版发布于2020年04月22日，此版升级内容包括：

1）发布错误码统一解决方案，详细参考手册的“附表 3”。
2）新增 34 条新规约。如：日期时间的闰年、闰月问题，三目运算的自动拆箱，SQL查询的表别名限定，Collectors 类的 toMap()方法使用注意等。
3）修改描述 90 处。如：阻塞等待锁、建表的小数类型等。
4）完善若干处示例。如：ISNULL 的示例等

▶ 关于华山版（v1.5.0）：
此版发布于2019年06月15日，并正式更名为《Java开发手册》，用发布者的话说：“它属于所有参与其中的贡献者，也以此聊表我们对全球Java开发者的感谢”。此版升级内容包括：

1）新增21条新规约。比如，switch的空指针问题、浮点数的比较、无泛型限制引起的类型混乱、加锁与解锁的注意事项、YYYY的日期格式问题等；
2）修改描述112处。比如，IFNULL的判断方式、集合的toArray的数组长度、日志占位符的处理等；
3）完善若干处示例。比如，变量命名示例、卫语句示例、枚举示例、finally的return示例等。

▶ 关于终极版（v1.3.1）：
本手册至今为止已更迭了三个版本，2017年9月25日，阿里巴巴Java开发手册（终极版）》正式发布，这是史上内容最全、修正最为彻底的一个版本，并且增加了单元测试规约内容，这也是阿里官方对外发布的最后一个PDF版本，值得收藏。

4、主要作者

杨冠宝：

杨冠宝：花名孤尽，取自《笑傲江湖》中风清扬的“独孤九剑，破尽天下武功”之意，是《阿里巴巴Java开发手册》的主要作者。在阿里巴巴集团历任研发、架构师、技术主管等不同的角色，承担过双11、国际化、代码中心等大型项目，有着丰富的一线编程经验，目前是研发协同平台Aone代码中心负责人。乐于分享与总结，在阿里巴巴集团内部大型分享多达30余次，不懈地追求技术创新，勇于挑战技术难度，在大数据、高并发、研发效能领域均有较深的造诣。

2016年3月，孤尽带领约码项目组编写《阿里巴巴Java开发手册(规约)》，码出高效，码出质量，推动阿里系与业界一起进步，让代码变得更舒服，更清澈，更好维护。

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

阿里高级研究员多隆：

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

阿里研究员毕玄：

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

阿里研究员玄难：

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

阿里巴巴B2B事业群CTO李纯：

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

阿里研究员、HipHop作者——赵海平（花名福贝）：

程序员是创造个性化作品的艺术家，但同时也是需要团队合作的工种。个性化应尽量表现在代码效率和算法方面，牺牲小我，成就大我。

6、《阿里巴巴Java开发手册(规约)》目录

一、编程规约 ...................................................................................................................................... 1
(一) 命名风格 ....................................................................................................................................... 1
(二) 常量定义 ....................................................................................................................................... 4
(三) 代码格式 ....................................................................................................................................... 5
(四) OOP规约 ....................................................................................................................................... 7
(五) 日期时间 .......................................................................................................................................11
(六) 集合处理 .......................................................................................................................................12
(七) 并发处理 .......................................................................................................................................17
(八) 控制语句 ....................................................................................................................................... 20
(九) 注释规约 ....................................................................................................................................... 24
(十) 前后端规约 ................................................................................................................................... 25
(十一) 其他 ...........................................................................................................................................27
二、异常日志 .......................................................................................................................................29
(一) 错误码 ...........................................................................................................................................29
(二) 异常处理 .......................................................................................................................................30
(三) 日志规约 .......................................................................................................................................32
三、单元测试 ......................................................................................................................................35
四、安全规约 .......................................................................................................................................37
五、MySQL数据库 ..............................................................................................................................38
(一) 建表规约 ........................................................................................................................................38
(二) 索引规约 ........................................................................................................................................39
(三) SQL语句 ........................................................................................................................................41
(四) ORM映射 .......................................................................................................................................42
六、工程结构 ........................................................................................................................................44
(一) 应用分层 .........................................................................................................................................44
(二) 二方库依赖 .....................................................................................................................................45
(三) 服务器 ............................................................................................................................................46
七、设计规约 ........................................................................................................................................48
附1：版本历史 .......................................................................................................................................51
附2：专有名词解释 ................................................................................................................................53
附3：错误码列表 ....................................................................................................................................54

7、部分内容截图预览

8、最新手册附件下载

《阿里巴巴Java开发手册(规约)》-终极版v1.3.1-共40页(52im.net).pdf (1.29 MB , 下载次数: 154 , 售价: 1 金币)

2 楼: x931609201 · 4 年前

有腾讯c++手册没

3 楼: JackJiang · 4 年前

引用：x931609201 发表于 2018-03-09 09:41
有腾讯c++手册没

暂时没有

4 楼: boylbz · 4 年前

《代码整洁之道》

5 楼: 大好人 · 4 年前

了解一下

6 楼: orchjoe · 3 年前

哈哈. 不错

7 楼: twwwww · 3 年前

8 楼: 夜影如歌 · 3 年前

正在学习Java，感谢分享宝贵经验！

9 楼: 417392086 · 3 年前

牛逼啊

10 楼: Dong99 · 3 年前

牛逼啊

11 楼: JackJiang · 3 年前

引用：Dong99 发表于 2019-05-12 09:29
牛逼啊

。。。

12 楼: imofly · 3 年前

感谢分享

13 楼: JackJiang · 3 年前

阿里巴巴技术团队于2019年06月15日发布华山版-v1.5.0（已在本贴附件中提供下载），并正式更名为《Java开发手册》！！

14 楼: JackJiang · 2 年前

阿里巴巴技术团队于2020年04月22日发布《Java开发手册v1.6.0-泰山版》，本贴附件下载已同步更新！

15 楼: sakula · 2 年前

谢谢分享

16 楼: JackJiang · 2 年前

阿里巴巴技术团队于2020年08月03日发布《Java开发手册v1.7.0-蒿山版》，本贴附件下载已同步更新！

17 楼: 李蒿 · 2 年前

蒿山是嵩山吧这不跟我名字一样了吗

18 楼: JackJiang · 2 年前

引用：李蒿发表于 2020-11-03 11:03
蒿山是嵩山吧这不跟我名字一样了吗

我文化程度低，嵩居然被我打错了。。。

19 楼: 天黑请闭嘴 · 2 年前

都嵩山版了。。

本文目录

1、前言

2、价值意义

3、最新动态

4、主要作者

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

6、《阿里巴巴Java开发手册(规约)》目录

7、部分内容截图预览

8、最新手册附件下载

附录：全站精品资源下载

本帖已收录至以下技术专辑

MobileIMSDK (v4.0精编版)

MobileIMSDK-Web (有偿开源)

RainbowAVnew (有偿开源)

RainbowChat (技术转让)

RainbowChat-Web (技术转让)

精华之王

白金版主

终身成就

即时通讯网

友情链接[友链交换]

关于

微信公众号new

本文目录

1、前言

2、价值意义

3、最新动态

4、主要作者

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

6、《阿里巴巴Java开发手册(规约)》目录

7、部分内容截图预览

8、最新手册附件下载

附录：全站精品资源下载

本帖已收录至以下技术专辑

MobileIMSDK(v4.0精编版)

MobileIMSDK-Web(有偿开源)

RainbowAVnew(有偿开源)

RainbowChat(技术转让)

RainbowChat-Web(技术转让)

精华之王

白金版主

终身成就

即时通讯网

友情链接[友链交换]

关于

微信公众号new

MobileIMSDK (v4.0精编版)

MobileIMSDK-Web (有偿开源)

RainbowAVnew (有偿开源)

RainbowChat (技术转让)

RainbowChat-Web (技术转让)

即时通讯网　