Skip to content

Java注释

在计算机编程中,Java编译器会完全忽略注释部分的代码。它们主要用于帮助程序员理解代码。例如,

java
// 声明和初始化两个变量
int a = 1;
int b = 3;

// 打印输出
System.out.println("This is output");

这里,我们使用了以下注释:

  • 声明和初始化两个变量
  • 打印输出

Java中的注释类型

在Java中,有两种类型的注释:

  • 单行注释
  • 多行注释

单行注释

单行注释在同一行开始和结束。为了编写单行注释,我们可以使用//符号。例如,

java
// "Hello, World!"程序示例

class Main {
    public static void main(String[] args) {    	
        // 输出"Hello, World!"
        System.out.println("Hello, World!");
    }
}

输出

Hello, World!

这里,我们使用了两个单行注释:

  • "Hello, World!"程序示例
  • 输出"Hello, World!"

Java编译器会忽略//到行末的内容。因此,它也被称为行尾注释


多行注释

当我们想要在多行上写注释时,可以使用多行注释。为了编写多行注释,我们可以使用/*....*/符号。例如,

java
/* 这是一个多行注释示例。
 * 程序将"Hello, World!"打印到标准输出。
 */

class HelloWorld {
    public static void main(String[] args) {

        System.out.println("Hello, World!");
    }
}

输出

Hello, World!

这里,我们使用了多行注释:

java
/* 这是一个多行注释示例。
* 程序将"Hello, World!"打印到标准输出。
*/

这种类型的注释也被称为传统注释。在这种类型的注释中,Java编译器会忽略/**/之间的内容。


正确使用注释

你应该考虑的一件事是,注释不应该成为解释代码错误的英语的替代品。你应该始终编写结构良好且自解释的代码。然后再使用注释。

有人认为代码应该是自描述的,很少使用注释。然而,在我个人看来,使用注释没有任何问题。我们可以使用注释来解释复杂的算法、正则表达式或在不同技术中选择一种技术来解决问题的情况。

注意:在大多数情况下,总是使用注释来解释“ 为什么 ”而不是“ 如何 ”,那么你就没错了。