阿里巴巴JAVA开发规范,代码规约
2022-08-15 11:04:50 962KB JAVA代码规范
1
代码规范比比皆是,但是很少有公司做好代码规范的。忍不住想谈谈代码规范的重要性,希望所有人都能够重视起来。而且,我相信,如果我们代码规范能够做好的话,且不说开发水平提高多少,至少我们也会有很多出色开源项目。 一、规范的代码可以促进团队合作 一个项目大多都是由一个团队来完成,如果没有统一的代码规范,那么每个人的代码必定会风格迥异。且不说会存在多个人同时开发同一模块的情况,即使是分工十分明晰的,等到要整合代码的时候也有够头疼的了。大多数情况下,并非程序中有复杂的算法或是复杂的逻辑,而是去读别人的代码实在是一件痛苦的事情。统一的风格使得代码可读性大大提高了,人们看到任何一段代码都会觉得异常熟悉。显然的,规范的代码在团队的合作开发中是非常有益而且必要的。 二、规范的代码可以减少bug处理 很多IT人士将程序员比做民工,这也的确非常的形象。就像刚才提到的,复杂的算法或逻辑只占项目中很小的比例,大多仅仅是垒代码的工作。可是越是简单,测试的bug反而是越多,而且是无穷无尽的bug。这里很大的程度上是由于代码不规范所致。 没有规范的对输入输出参数的规范,没有规范的异常处理,没有规范的日志处理等等,不但导致了我们总是出现类似空指针这样低级的bug而且还很难找到引起bug的原因。相反,在规范的开发中,bug不但可以有效减少,查找bug也变得轻而易举。 规范不是对开发的制约,而确实是有助于提高开发效率的。 三、规范的代码可以降低维护成本 随着我们项目经验的累积,会越来越重视后期维护的成本。而开发过程中的代码质量直接影响着维护的成本。因此,我们不得不从开发时便小心翼翼。 在第一点中曾提到,规范的代码大大提高了程序的可读性,几乎所有的程序员都曾做过维护的工作,不用多说,可读性高的代码维护成本必然会大大降低。 但是,维护工作不仅仅是读懂原有代码,而是需要在原有代码基础上作出修改。我们可以先想像没有统一风格的情况下,A完成开发以后,B进行维护加一段代码,过一段时间C又加一段代码。。。。。。直到有一天X看到那一大堆乱码想死的心都有了,维护也就进行不下去了。因此,统一的风格有利于长期的维护。 另外,好的代码规范会对方法的度量、类的度量以及程序耦合性作出约束。这样不会出现需要修改一个上千行的方法或者去扩展一个没有接口的类的情况。规范的代码对程序的扩展性提高,无疑也是对维护人员的一个奖励。 四、规范的代码有助于代码审查 我个人是比较赞同进行代码审查的,这样可以及时纠正一些错误,而且可以对开发人员的代码规范作出监督。团队的代码审查同时也是一个很好的学习机会,对成员的进步也是很有益的。但是,开发随意,加重的代码审查的工作量及难度,并且使得代码审查工作没有根据,浪费了大量的时间却收效甚微。 代码规范不仅使得开发统一,减少审查拿督,而且让代码审查有据可查,大大提高了审查效率和效果,同时代码审查也有助于代码规范的实施。一举多得,何乐而不为呢。 五、养成代码规范的习惯,有助于程序员自身的成长 即使明白代码规范的好处,但是有的迫于项目压力,有的因为繁琐的规范作出很多额外的工作,更有的不重视维护的问题,而很难贯彻代码规范。 那么,我们需要了解,规范开发最大的受益人其实是自己! 你有没有花费很多的时候查找自己的代码呢?尤其是出现bug的时候需要逐行的debug?自己写的代码乱了头绪的确实也见了不少。我们应该做的就是规范开发,减少自己出现的错误。很多时候项目的压力一部分也是由于前期开发中遗留的众多的问题。 还有的人觉得自己可以完成高难度的算法,就认为自己能力很强,不把规范放在眼里。很多人确实是这样,追求个性,大概让别人看他的代码一头雾水更觉得得意。殊不知复杂的算法确实可以体现你个人的逻辑能力,但是绝不代表你的开发水平。我们知道一些开源项目,一些大师级人物写得程序都是极其规范的。并非规范了就代表高水平,实际上是规范的代码更有利于帮助你理解开发语言理解模式理解架构,能够帮助你快速提升开发水平。不明白这点,即使你写的再高明的算法,没准哪天也被当作乱码别处理掉。 记住!每天垒乱码(或许你不觉得,但是大多时候在别人眼中确实就是乱码)并不能使你获得更多的进步,相反要达到高水平的程序员,养成良好的开发习惯是绝对必需的。 不要沉迷表面的得失,看似无用的东西要经过慢慢的累积由量变达到质变的时候,你才能感受到其价值所在。 最后提醒一句,制定一个符合自己公司情况的开发规范是很简单的,重要的是我们能够认识到规范的重要性,并坚持规范的开发习惯。
2022-05-18 15:08:59 852KB 代码规范 eclipse规范 开发规范 java
1
代码编程规范(含java\c#\c++),对统一团队编码规格标准有帮助
2022-04-08 18:05:51 1.11MB c# c++ java 代码规范
1
java代码checkstyle的规范检查点特别多。再加上同时还有部门自己的一套编码规范,在eclipse开发环境中,研发人员很难驾驭如此多的条条框框。本文提供的技术能轻松的解决研发人员关于编码规范的苦恼,因为这部分工作由本人提供的脚本已完全能够自动生成。当然这里的编码规范不包括java语言本身的使用机制,也就是说java代码的使用与否只能由研发人员控制,不可能由自动化脚本完成。 使用本文技术的好处: 1. 能把checkstyle检查单中检查出的80%的错误自动排除,如关于tab键的使用问题。如果不使用本人的脚本,每个研发人员要在eclipse中配置一遍或干脆不使用tab键,加上eclipse使用上并不直观并且该软件经常出错,所以对研发人员来说这是很痛苦的一件事情。当然编码规范远远不止tab的禁止使用问题,如空格,换行等很多细节问题,所以每次都要这样配置,将极大的影响工作效率; 2. 把checkstyle中的大部分错误排除后,即使checkstyle检查单中还有少量错误,也往往是与具体的编码有关,这对研发人员集中精力于java技术本身就非常有意义了; 3. 由于本人提供的自动化脚本既包括注释的规范化,同时也包括对代码格式的规范化,这对提升java代码整体质量意义重大; 4. 把研发人员从纠缠于编码规范细节的锁细工作中解脱出来,极大地提升了工作效率,否则光是看到checkstyle检查单上的一堆错误,不仅伤及信心,同时要逐个去纠正,工作量将极其巨大; 建议:由于本文提供的技术十分实用,建议在部门尽快推广使用之,这对提升过程质量及研发人员的工作效率非常有帮助。
1
JAVA代码规范.doc
2021-10-25 16:01:59 107KB java
1
华为的代码规范,列举的比较全面,手头有其他规范资料的,大家可以对比着看,可能会有更多的灵感触发哦
2021-09-16 08:19:08 644KB 华为 java 代码规范
1
阿里巴巴代码扫描插件离线安装版
1
包含idea和eclipse的两种插件及阿里巴巴java开发规范文档,本人亲测开源使用,内附详细安装说明,测试环境为: jdk7, eclipse Mars.2 Release (4.5.2) IntelliJ idea 2017.1.2
1
该文档中及个别答案不准,仅供参考,反正我是考过了.就看着这个.
2021-08-24 14:53:23 8.94MB java代码规范
1
Java开发代码规范,用于行业内部开发的准则,包括开发标准和开发技巧。
2021-06-20 20:24:19 860KB Java 代码规范
1