献给开发者们！《#阿里巴巴java开发手册#》实体书开启预售！书中独家披露设计规约，根据阿里巴巴一线架构设计经验沉淀而成，旨在帮助研发人员准确地度量是否需要定向的设计方案。

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

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

如果有兴趣了解更多，可第一时间上天猫购得此书，参与文末互动还有机会免费获得作者签名版图书！

我们也有幸邀请了作者孤尽，请他来聊聊规约背后的故事与初心。

class="video_iframe" data-vidtype="2" allowfullscreen="" frameborder="0" data-ratio="1.7647058823529411" data-w="480" data-src="http://v.qq.com/iframe/player.html?vid=c056193oi6c&width=670&height=376.875&auto=0" style="display: block; width: 670px !important; height: 376.875px !important;" width="670" height="376.875" data-vh="376.875" data-vw="670" src="http://v.qq.com/iframe/player.html?vid=c056193oi6c&width=670&height=376.875&auto=0"/>

孤尽说：

别人都说我们是搬砖的码农，但我们知道自己是追求个性的艺术家。也许我们不会过多在意自己的外表和穿着，但在我们不羁的外表下，骨子里追求着代码的美、系统的美，代码规范其实就是一个对程序美的定义。

但是这种美离程序员的生活有些遥远，尽管编码规范的价值在业内有着广泛的共识，在现实中却被否定得一塌糊涂。工程师曾经最引以为豪的代码，因为编码规范的缺失、命名的草率而全面地摧毁了彼此的信任，并严重地制约了相互的高效协同。工程师一边吐槽别人的代码，一边写着被吐槽的代码，频繁的系统重构和心惊胆战的维护似乎成了工作的主旋律。

那么如何走出这种怪圈呢？

众所周知，互联网公司的优势在于效率，它是企业核心竞争力。体现在产品开发领域，就是沟通效率和研发效率。对于沟通效率的重要性，可以从程序员三大“编程理念之争”说起：

1. 缩进采用空格键，还是Tab键。

   
   

2. if单行语句需要大括号，还是不需要大括号。

   
   

3. 左大括号不换行，还是单独另起一行。

1. 缩进采用空格键，还是Tab键

在美剧《硅谷》中，你也许会记得这样一个经典镜头：主人公Richard与同为程序员的女友分手，理由是两人对缩进方式有着不同的习惯，互相拧巴地鄙视着对方的cody style。Tab键和空格键的争议在现实编程工作中确实存在。

《阿里巴巴Java开发手册》（以下简称“《手册》”）明确地支持了4个空格的做法，如果一定要问理由，没有理由，因为能够想出来的理由，就像最坚固的盾一样，总有更加锋利的矛会戳破它。只想说，一致性很重要，无边无际争论的时间成本与最后的收益是成反比的。

2. if单行语句需要大括号，还是不需要大括号

if单语句是否需要换行，也是争论不休的话题。相对来说，写过格式缩进类编程语言的开发者，更加习惯于不加大括号。

《手册》中明确if/for单行语句必须加大括号，因为单行语句的写法，容易在添加逻辑时引起视觉上的错误判断。此外，if不加大括号还会有局部变量作用域的问题。

3. 左大括号不换行，还是单独另起一行

因为Go语言的强制不换行，在这点上，“编程理念之争”的销烟味没有那么浓。如果一定要给一个理由，那么换行的代码可以增加一行，对于按代码行数考核工作量的公司员工，肯定倾向于左大括号前换行。

《手册》明确左大括号不换行。

这些理念之争的本质就是自己多年代码习惯生的茧，不愿意对不一样的风格妥协，不愿意为了团队的整体效能提升而委屈自己。其实，很多编程方式客观上没有对错之分，一致性很重要，可读性很重要，团队沟通效率很重要。

有一个理论叫帕金森琐碎定律：一个组织中的成员往往会把过多的精力花费在一些琐碎的争论上。程序员天生需要团队协作，而协作的正能量要放在问题的有效沟通上。个性化应尽量表现在系统架构和算法效率的提升上，而不是在合作规范上进行纠缠不休的讨论、争论，最后没有结论。规范不一，就像下图中的小鸭子和小鸡对话一样，言语不通，一脸囧相。

鸡同鸭讲也恰恰形容了人与人之间沟通的痛点，自说自话，无法达成一致意见。再举个生活中的例子，交通规则靠左行还是靠右行，两者孰好孰坏并不重要，重要的是必须要在统一的方向上通行，表面上限制了自由，但实际上是保障了公众的人身安全。试想，如果没有规定靠右行驶，那样的路况肯定拥堵不堪，险象环生。同样，过分自由随意、天马行空的代码会严重地伤害系统的健康，影响到可扩展性及可维护性。

因此，阿里云还上线了Java代码在线检测功能，快来为你的代码做个X光扫描，看看你的代码中哪些是不符合规范的吧！

第1步：登录阿里云RDC平台

使用阿里云账号登录研发协同RDC平台，链接：https://rdc-test.aliyun.com/

如果提示没有所属企业，则需要新建一个企业（企业名称可以自由填写），可以看到“阿里巴巴Java代码规约扫描”测试任务。

第2步：上传Java代码

点击左侧的【代码】，在右侧新建Git组和Git库，并向该库提交要进行测试的java项目代码，并复制Git库地址。

第3步：新建测试任务

返回测试任务界面（https://rdc-test.aliyun.com/），点击“阿里巴巴Java代码规约扫描”测试任务，新建测试任务，填写上一步复制的Git库地址，点击【确定】按钮。

第4步：运行测试

点击右侧【运行】按钮，开始进行代码扫描。

第5步：查看结果

点击数字，查看详细扫描报告。

在留言区，聊一聊你为什么想看这本书，就有机会免费获得作者签名版的《阿里巴巴Java开发手册》一本，随机抽取5名童鞋送出。

活动时间：即日起至12月22日，获奖名单届时将在留言区公布。

-END-

云栖社区

ID：yunqiinsight

云计算丨互联网架构丨大数据丨机器学习丨运维