阿里重磅出击，整理形成每个优秀程序员都应遵循的代码原则和规范

Posted 2020-12-13 bwscode

前言

现代软件行业的高速发展对开发者的综合素质要求越来越高,因为不仅是编程知识点,其它维度的知识点也会影响到软件的最终交付质量。比如:数据库的表结构和索引、设计缺陷可能带来软件上的架构缺陷或性能风险、工程结构混乱导致后续维护艰难、没有鉴权的漏洞代码易被黑客攻击等等。

那这样的话，我们在项目开发的过程中，就需要要更加优秀的程序猿，但是，这个优秀不仅仅是技术能力牛逼，还有其他方面，我们来看一下。

什么是优秀的程序员?

首先我们会先提出这个问题，如果你向10个人问这个问题，尽管可能答案不同，但是少有一点应该是一致的。而对我个人而言，一个优秀的程序员应该是一个能够充分理解需求，并能提出可行性解决方案通过团队协作向最终用户展示成果。而说到团队协作，就涉及到代码的可维护性，那么你该如何管理庞大的代码库？如果放任团队成员提交随意的代码，那么在项目中无论在bug修复还是新增功能，都将很难完成。

如果想要实现可维护这个目标，那么团队中的每个成员都应该保证提交整洁且可维护的代码。那么您应该让你的团队成员遵守一定的编码原则。遵守这些原则，可以使你和其他人的协作变得更容易。所以团队成员应该遵循什么样的规则呢？

童子军原则

童子军是美国社会针对未成年人的一种教育实践制度，加入童子军的小朋友都要学习并遵守一些规则，然后获得各种各样的勋章。其中一条规则是离开宿营地前进行清扫活动的原则，简洁明了：

Leave the campground cleaner than you found it.

假设某个小朋友来到某个宿营地，不幸发现地上有两处垃圾，然后他自己在接下来的日常活动中也制造了一处垃圾。那么当他离开时，不仅要清理掉自己的垃圾，还要处理早先小朋友留下的两处垃圾。应把注意力放在为下一个露营者创造更好的环境，而不是去寻找是谁丢的。

这个原则放到软件生产中则意味着让check in比check out时更整洁，至少不要让代码变得更糟糕。

 

避免重复

尽量在项目的开发过程中减少产出重复的代码、方法和类，多数的设计模式根本目的是为了减少代码重复，尽可能将重复使用的代码抽象封装，是提高代码的可重用性和可维护性的最佳方式之一。

功能独立

这里功能独立的意思是指，函数或方法尽可能简单，功能尽可能独立。

换句话来讲就是，一个方法最好只做一件事，如果你觉得你的代码过于复杂，该怎么做？抽方法。

初级程序员最常犯的错误就是在一个方法中包含了很多种要做的工作，这可能会在软件的生命周期带来灾难。

简单易懂的代码比“聪明“的代码更好

程序员作为社会中最聪明的群体之一，往往在写代码时也会产出一些炫技的代码块，这部分代码块过段时间再去看，就像谜一样存在于程序中，虽然很简洁，但并不易读。

例如：有些人在程序中喜欢使用三目运算而非if-else，虽然本身使用三目运算符没有问题，但存在嵌套情况时，那么对于后面的维护者就是一场噩梦，例如如下代码：

(A>B?(A>C?A:C):(B>C?B:C))

其实上面的代码等同于，显然下面的格式更易懂

if(A>B){
    (A>C?A:C)
}else{
    (B>C?B:C)
}

迪米特法则

迪米特法则是1987年秋天由lan holland在美国东北大学一个叫做迪米特的项目设计提出的，它要求一个对象应该对其他对象有最少的了解，所以迪米特法则又叫做最少知识原则。它的意义旨在降低类和类之间的耦合，避免发生由于耦合度过大造成的因为一个类发生变化，而对另一个类造成影响。

YAGNI

YAGNI原则是指在开发时只需要将应用程序必需的功能包含进来，而不要试图添加任何其他你认为可能需要的功能。开发过程中为了应对将来可能的提出的需求，提前开发一些功能进去，我们通常会花不少时间成本在这些过度设计的功能开发上，但可能未来的两三年内这个设计根本没有用到。应把更多的精力花在更重要的功能开发上，适度假设未来需求的规划，加速后期功能迭代和代码维护。

 

总结

虽然上面提了很多原则和规范，但这些规范需要在长期在工作中的实践才能有更深的理解的。希望您能从本文中了解一些基础，最后，希望大家都能写出优美、规范的代码。

 

---

不过，这上面就是一些笼统的概念，是大家都会知道的一些方案，就像画大饼一样，在知道大致的方向之后，我们就来看我们该如何去做

但是，怎么做肯定不能是我们的信口开河，说怎么样就怎么样，就把这个规范给制定了，对吧，那是不是有什么参考呢？对的，没问题，中国有几大互联网公司，其中老大就是我们的阿里，而阿里除了作为品牌和风向标之外，也根据他们在开发的过程中给遇到的问题，整理这样的两份资料

Java开发手册泰山版

 

Java开发手册华山版

 

详细介绍

今天呢，给大家主要介绍的是更新之后的版本---泰山版。泰山版和华山版除了内容上的更新外，更是在最后添加了错误码列表，希望这份资料会对大家的编码有所帮助

关注公众号：Java架构师联盟，每日更新技术好文，后台回复1000查看精美面试文档

需要这份开发规范，添加小助手：msbxq2020免费获取

目录

 

每一个需要注意的编码规范，下面都会有相应的说明、正例以及反例

 

架构层次

 

名词解释

 

错误代码

 

需要这份资料的，关注+转发后，私信“资料”查看获取方式