2.6 代码注释与编码规

在程序代码中适当地添加注释,可以提高程序的可读性和可维护性。好的编码规范可以使程序更易阅读和理解。本节将介绍Java中的几种代码注释方法以及应该注意的编码规范。

2.6.1代码注释

通过在程序代码中添加注释可提高程序的可读性。注释中包含了程序的信息,可以帮助程序员更好地阅读和理解程序。在Java源程序文件的任意位置都可添加注释语句。注释中的文字Java编译器不进行编译,所有代码中的注释文字对程序不产生任何影响。Java语言提供了3种添加注释的方法,分别为单行注释、多行注释和文档注释。

1.单行注释

"//"为单行注释标记,从符号"//"开始直到换行为止的所有内容均作为注释而被编译器忽略。语法如下:

//注释内容

例如,以下代码为声明的int型变量添加注释:

int age; //定义int型变量,用于保存年龄信息

2.多行注释

"/**/"为多行注释标记,符号"/*"与"*/"之间的所有内容均为注释内容。注释中的内容可以换行。语法如下:

/*

注释内容1

注释内容2

...

*/
注意:

(1)在多行注释中可嵌套单行注释。例如:

/*

程序名称:Hello world //开发时间:2021-03-05

*/

(2)多行注释中不可以嵌套多行注释,以下代码是错误的:

/*

程序名称:Hello world

/*开发时间:2021-03-05; 作者:张先生*/

*/

3.文档注释

"/***/"为文档注释标记。符号"/**"与"*/"之间的内容均为文档注释内容。当文档注释出现在声明(如类的声明、类的成员变量的声明、类的成员方法的声明等)之前时,会被Javadoc文档工具读取作为Javadoc文档内容。除注释标记不同外,文档注释的格式与多行注释的格式相同。对于初学者而言,文档注释并不是很重要,了解即可。

说明:一定要养成良好的编程习惯。软件编码规范中提到"可读性第一,效率第二",所以程序员必须在程序中添加适量的注释来提高程序的可读性和可维护性。程序中,注释要占程序代码总量的20%~50%。

2.6.2编码规范

在学习开发的过程中要养成良好的编码习惯,规整的代码格式会为程序日后的维护工作提供极大的便利。在此对编码规则做了以下总结,供读者学习:

☑ 每条语句尽量单独占一行,每条语句都要以分号结束。

注意:程序代码中的分号必须为英文状态下输入的,初学者经常会将";"写成中文状态下的";",此时编译器会报出Invalid Character(非法字符)这样的错误信息。

☑在声明变量时,尽量使每个变量单独占一行,即使有多个数据类型相同的变量,也应将其各自放置在单独的一行上,这样有助于添加注释。对于局部变量,应在声明的同时对其赋予初始值。

☑在Java代码中,空格仅提供分隔使用,无其他含义,开发者应控制好空格的数量,不要写过多的无用空格。例如:

public static void main ( String args )

等价于

public static void main(String args\[\])

☑为了方便日后的维护,不要使用技术性很高、难懂、易混淆的语句。因为程序的开发者与维护者可能不是同一个人,所以应尽量使用简洁、清晰的代码编写程序需要的功能。

☑对于关键的方法要多加注释,这样有助于阅读者了解代码的结构与设计思路。

代码应该写在哪?这可能是第一次学习编程的读者最大的疑惑了。作者对Java代码的主要结构做出了几点总结:

☑package语句要写在类文件的第一行。如果类不在任何包中,可以不写package语句。

☑import语句要写在类上方、package语句下方。

☑方法必须写在类的{ }之内。方法的{ }内不可以创建其他方法。

☑类的成员变量必须定义在类的{ }之内、方法的{ }之外的位置。方法的{ }之内定义的变量均为局部变量。

☑除了上面几种类型的代码,其他类型代码都应该写在某个{ }中(如代码块或方法体之内)。其他类型的代码包括局部变量、内部类等。

如果你现在无法读懂这几点总结,请不要焦虑,只要勤加练习,这些注意事项自然就会掌握。

相关推荐
布莱克6055 小时前
Swift 类详解:从定义、继承到内存管理的完整指南
服务器·开发语言·ios·ssh·swift·类
是main不是漫6 小时前
【快慢指针 | LeetCode202 快乐数】鸽巢原理佐证环特性,快慢指针巧解快乐数
c语言·开发语言·c++·算法
果果软件6 小时前
2026 后台管理系统选型:若依、JeecgBoot、芋道、NocoBase 和 GewuMind Boot 怎么选?
java·人工智能·后端·ai·开源
布莱克6057 小时前
Swift 方法详解:实例方法、类型方法与 mutating 机制
服务器·开发语言·ios·ssh·swift·方法
Risehuxyc9 小时前
PHP能不能在参数里放匿名函数
开发语言·php
码云社区9 小时前
Java家政服务系统源码:人员技能、服务范围与多商家业务落地
java·开发语言·家政服务·家政小程序·家政系统
FRing0310 小时前
vue3干货总结3(defineOptions(Vue3.3)、defineModel(Vue3.4)、Pinia)
开发语言·前端·vue.js·vue3
摇滚侠10 小时前
《On Java 中文版 基础卷》阅读笔记 接口 18
java·笔记·python
CoderYanger10 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第八弹):MyBatis Generator
java·数据库·spring boot·spring·java-ee·tomcat·mybatis
whitelbwwww11 小时前
CUDA C++实战--中级
开发语言·前端·c++