阿里巴巴 Java 开发规范手册分享

  发表人 Seves

原名《阿里巴巴Java开发手册》,但我更喜欢叫《阿里巴巴 Java 开发规范手册》。分享给 Java 相关开发人员,对 Java 开发中的命名、异常、日志、工程等进行规范的参考文档。本文记录了此手册从最初版到最新版的所有更新记录,并将一直保持更新。 :heart:

2017-05-20 更新 1.2.0 版(迄今最完善版本)

版本号 制定团队 更新日期 备注
1.2.0 阿里巴巴集团技术团队 2017.5.20 公开征集意见后的修正版本。
  1. 阿里巴巴Java开发规范手册(1.2.0).pdf
  2. v1.2.0 版阿里云下载

本次更新说明:
在收集外部建议和阿里内部经验更新的基础上,阿里规约项目组正式推出《阿里巴巴Java开发手册》1.2.0升级版,堪称史上最完善版本。


2017-03-31 更新 1.1.1 版

版本号 制定团队 更新日期 备注
1.1.1 阿里巴巴集团技术团队 2017.3.31 修正页码总数和部分示例。
  1. 阿里巴巴Java开发规范手册(1.1.1).pdf
  2. v1.1.1 版阿里云下载

2017-02-27 更新 1.1.0 版

版本号 制定团队 更新日期 备注
1.1.0 阿里巴巴集团技术团队 2017.2.27 增加前言和专有名词说明,修正部分描述。
  1. 阿里巴巴Java开发规范手册(1.1.0).pdf
  2. v1.1.0 版云存储备用下载链接

来源

原文内容:
2017年开春之际,诚意献上重磅大礼:阿里巴巴Java开发手册,首次公开阿里官方Java代码规范标准。这套Java统一规范标准将有助于提高行业编码规范化水平,帮助行业人员提高开发质量和效率、大大降低代码维护成本。
点击下载《阿里巴巴Java开发手册》(v1.1.0版): https://yq.aliyun.com/attachment/download/?id=1200
v1.1.0版更新说明:1)增加手册前言。2)增加版本历史。3)增加专有名词解释。

阿里巴巴Java开发手册快速学习


2017-02-08 正式版发布

版本 制定团队 更新日期 备注
1.0.0 阿里巴巴集团技术团队 2017.2.9 正式版
  1. 阿里巴巴Java开发规范手册(正式版).pdf
  2. 正式版云存储备用下载链接

来源


2016-12-07 首次向 Java 业界公开

版本 制定团队 更新日期 备注
1.0.0 阿里巴巴集团技术部 2016.12.7 首次向 Java 业界公开
  1. 阿里巴巴Java开发规范手册.pdf
  2. 云存储备用下载链接

阿里巴巴Java开发规范手册

来源

手册前言

《阿里巴巴 Java 开发手册》是阿里巴巴集团技术团队的集体经验总结,经历了 多次大规模一线实战的检验及不断的完善,反馈给广大开发者。现代软件行业的高速 发展对于开发者的综合素质要求越来越高,因为不仅是编程知识点,其它维度的知识 点也会影响到软件的最终交付质量。比如:数据库的表结构和索引设计缺陷可能带来 软件上的架构缺陷或性能风险;工程结构混乱导致维护困难;没有鉴权的漏洞代码被 黑客攻击等等。所以本手册以 Java 开发者为中心视角,划分为编程规约、异常日志规 约、MySQL 规约、工程规约、安全规约五大块,再根据内容特征,细分成若干二级子目 录。根据约束力强弱及故障敏感性,规约依次分为强制、推荐、参考三大类。对于规 约里的内容,“说明”对内容做了引申和解释;“正例”提倡什么样的编码和实现方 式;“反例”说明需要提防的雷区,以及真实的错误案例。

本手册的愿景是码出质量、码出高效。代码的字里行间流淌的是软件生命中的血
液,质量的提升是尽可能少踩坑,杜绝踩重复的坑,切实提升质量意识。另外,现代
软件架构都需要协同开发完成,高效考虑的是降低协同成本,所谓无规矩不成方圆,
无规范不能协作。众所周知,制订交通法规表面上是要限制行车权,实际上是保障公
众的人身安全。试想如果没有限速,没有红绿灯,没有规定靠右行驶,谁还敢上路行
驶。对软件来说,适当的规范和标准绝不是消灭代码内容的创造性、优雅性,而是限
制过度个性化,以一种普遍认可的统一方式一起做事,提升协作效率。

《阿里巴巴 Java 开发手册》,开放包容地认真总结社区、博客、论坛的反馈,及 时修正,保持与时俱进。请关注手册末页的“阿里技术”和“云栖社区”公众号获取 最新版。


作者:星柒天出处:https://zixizixi.cn/
本文发布于 子兮子兮 博客,欢迎转载,但未经作者同意请保留此声明,并在文章页面明显位置给出原文连接。

1,981