编程规范超详细
  0igIJDzjah01 2023年11月13日 17 0


目录

背景介绍       

规范模块

代码命名

编码格式

代码注释

异常处理

引入外部依赖

版本控制

遵循的好处

总结提升


背景介绍       

        所谓编程规范不过就是对代码的一些统一和管理,因为程序的开发是需要和别人一起去完成的,如果你写的代码别人都看不懂就不能一起合作完成一项开发。更何况在当前软件行业迅猛的发展下,软件逐渐走向大型化。在这种软件走向大型化的形势下,一个软件需要众多的人参与。比如一个操作系统的开发需要上千人的工作。这样我们就不得不面临着如何管理。这时编程规范就可以让我们能够达到统一,在多人合作的时候也大大提高了效率。

规范模块

代码命名

                                         Pascal命名法:所有单词的首字母都大写,其他字母小写

                                  Camel命名法:除首字母外,其他单词的首字母大写,其他字母小写

       代码的名字能够表示事物的特性。名字一律使用英文单词,而不能用拼音去命名,可以有两个或三个单词组成,但不能多余4个,一般控制在3~30个字母之内。如果在名字中,多个单词用大写第一个字母(其他字母小写)来分隔。在类属性的名称中包含类名时候多余的,如Book.BookTitle。而是应该使用Book.Title。及时和对于可能仅出现在几个代码行中的生存期很短的变量,仍然使用有意义的名称。仅对于短循环索引使用单字母变量名,如 i 或 j。

编码格式

1.大括号

IF (expression)   

            {



            }

或:

            IF (expression) {



            }

2.小括号

if (true)

   {

               

   }

       不要把小括号和关键词(if 、while等)紧贴在一起,要用空格隔开它们。如果存在多个语句嵌套,需要把嵌套的语句进行缩进,要分清语句的开头和结尾并对应好。

代码注释

       代码的注释是对代码可读性的进一步提高,良好的注释可以大大增加代码的辨识度,注释保持一致性可以更便于开发人员互相了解开发进度,省去不必要交流,所以注释也应该保持一直的规范。例如;对代码的解释说明,在文件开头说明作者,小组,说明,创建日期,版本号等信息;在模块、类、属性、方法前一行添加注释,以便调用的时候提示用户。

异常处理

  • 不要捕获异常而不做任何处理,至少应该打印异常堆栈信息。
  • 使用具体的异常类型来捕获异常,避免捕获Exception类。
  • 在必要的情况下,使用try-with-resources语句来自动关闭资源。

引入外部依赖


  • 使用Maven、Gradle等构建工具来管理项目的依赖
  • 避免引入过多的第三方库,尽量使用Java标准库提供的功能。
  • 定期检查和更新依赖,以获取最新的功能和修复的bug。

版本控制

  • 使用版本控制系统(如Git)来管理代码的版本和变更历史。
  • 提交代码前进行代码审查,确保代码质量和风格的一致性。
  • 使用合适的分支策略,如主分支、开发分支和特性分支。

遵循的好处

  1. 提高代码的可读性:编程规范定义了一致的命名约定、缩进和空格规则等,使代码更易读、易于理解。这有助于开发人员快速理解代码的意图和逻辑,减少阅读代码的时间和精力。
  2. 提高代码的可维护性:遵循编程规范可以使代码结构清晰、模块化,减少代码的复杂性和耦合度。这使得代码更易于修改、扩展和维护,减少引入bug的可能性,并且方便其他开发人员理解和修改代码。
  3. 提高代码的质量:编程规范鼓励使用合适的设计模式和最佳实践,避免使用过长的方法、复杂的逻辑和重复的代码。这有助于编写高质量、可靠、可测试的代码,减少bug的产生和修复的成本。
  4. 提高团队协作:编程规范定义了统一的代码风格和约定,使团队成员能够更好地协作和交流。代码风格的一致性可以减少代码审查的时间和精力,提高团队的工作效率和合作效果。
  5. 降低项目风险:遵循编程规范可以减少潜在的风险和问题。规范要求使用合适的异常处理、并发控制和资源释放机制,以避免内存泄漏、死锁和其他常见的问题。这有助于提高系统的稳定性和可靠性。

总结提升

        遵循这些规范可以提高代码的可读性、可维护性和可扩展性,减少bug的产生和维护的成本。同时,良好的编程规范也有助于团队协作和代码的可理解性。

编程规范超详细_java

【版权声明】本文内容来自摩杜云社区用户原创、第三方投稿、转载,内容版权归原作者所有。本网站的目的在于传递更多信息,不拥有版权,亦不承担相应法律责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@moduyun.com

  1. 分享:
最后一次编辑于 2023年11月13日 0

暂无评论

推荐阅读
  xaeiTka4h8LY   2024年05月17日   51   0   0 数据库JavaSQL
  2iBE5Ikkruz5   2023年12月12日   92   0   0 JavaJavaredisredis
0igIJDzjah01