编程规范超详细

简介: 编程规范超详细

背景介绍      

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

规范模块

代码命名

                                        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的产生和维护的成本。同时,良好的编程规范也有助于团队协作和代码的可理解性。

相关文章
|
7月前
|
自然语言处理 算法 Java
C/C++ 程序员编程规范之注释
C/C++ 程序员编程规范之注释
262 1
|
7月前
|
程序员 编译器 C++
|
7月前
|
存储 算法 测试技术
|
前端开发 JavaScript 程序员
如何编写高质量代码
如何编写高质量代码
91 0
|
设计模式 人工智能 缓存
【C#编程规范 一】编程规约(上)
【C#编程规范 一】编程规约(上)
301 0
|
编译器 C++
【C++】实用编程规范与建议
C++ 相关,比较实用的 防止疏漏出错的编码规范与编码建议
198 0
|
程序员
编程规范
编程规范
104 0
|
程序员 C语言 Windows
编程规范(一)变量命名
编程规范(一)变量命名
|
算法 Java
Java编程——编写高质量代码的思考
                                                 前言        最近在看《代码大全》,可以说是一本软件开发的百科全书,特别厚,但是干货也很多。
1148 0