java怎样用/**/添加多行注释 java多行注释语句的基础教程-java教程-PHP中文网

java怎样用/**/添加多行注释 java多行注释语句的基础教程

看不見的法師

发布： 2025-08-08 16:31:01

原创

763人浏览过

<p>java中写多行注释最直接的方式是使用/和/，1. 它能包裹多行文字或代码，使编译器忽略其内容；2. 与单行注释//相比，/ /更适合解释复杂逻辑或整体设计思路，支持跨行叙述，便于临时禁用代码块；3. 实际开发中常用于说明非自解释代码、临时注释代码区域，但需避免过度注释、保持注释同步更新，并注意/ /不支持嵌套；4. 除多行注释外，java还提供单行注释//用于简短说明，以及javadoc注释/ /用于生成api文档，后者通过@param、@return等标签自动生成html文档，提升代码可维护性；综上，合理使用//、/ /和/ /三种注释方式是编写高质量java代码的关键。</p>

java怎样用/**/添加多行注释 java多行注释语句的基础教程

Java里，如果你想写一段跨越多行的注释，最直接的方式就是使用

/*

登录后复制

和

*/

登录后复制

这对符号。它能让你把一大段说明文字或者暂时不需要运行的代码包裹起来，让编译器直接忽略掉，非常方便。

要使用

/* */

登录后复制

添加多行注释，你只需要在注释内容的起始位置放一个

/*

登录后复制

，然后在注释内容的结束位置放一个

*/

登录后复制

就行了。这两者之间的所有内容，无论是多少行，都会被Java编译器视为注释，不参与程序的编译和执行。

举个例子，就像这样：

立即学习“Java免费学习笔记（深入）”；

public class CommentExample {
    public static void main(String[] args) {
        /*
         * 这是一个多行注释的例子。
         * 我可以在这里写很多行文字，
         * 解释我的代码逻辑，
         * 甚至暂时禁用一大段代码。
         */
        System.out.println("Hello, World!"); // 这是一行普通代码

        /*
        int a = 10;
        int b = 20;
        System.out.println(a + b);
        */ // 这段代码被注释掉了，不会执行
    }
}

登录后复制

你看，它非常直观，就像给一段文字加了个边框，告诉编译器：“嘿，这块内容你别管，这是给人看的。”

为什么我们需要多行注释，它和单行注释有什么区别？

这个问题，在我看来，其实挺核心的。我们写代码，不光是为了让机器跑起来，更重要的是让人能看懂，尤其是未来维护你代码的人，或者几个月后回过头来看自己代码的你。单行注释

//

登录后复制

当然好用，它适合快速标注一行代码的意图，或者某个变量的含义。但当你需要解释一个复杂的算法流程，或者一段功能模块的整体思路时，一行行的

//

登录后复制

就会显得非常零碎，甚至有些碍眼。

这时候，

/* */

登录后复制

的优势就体现出来了。它提供了一个“区域”，你可以自由地在里面组织你的文字，写出完整的句子、段落，甚至画个简单的ASCII图。我个人觉得，它更像是一种“叙述性”的注释，用来描述“为什么”这样做，或者“这段代码的整体目的是什么”。而

//

登录后复制

更多是“是什么”和“怎么做”的局部说明。

另一个大区别在于，

/* */

登录后复制

可以很方便地用来“禁用”一大块代码。比如你在调试的时候，想暂时跳过某段逻辑，或者测试不同实现方式，直接把那段代码用

/* */

登录后复制

包起来就行，比一行行删掉或者改用

//

登录后复制

要高效得多。这在排查问题时，简直是神器。

在实际开发中，多行注释有哪些常见的使用场景和注意事项？

实际开发里，多行注释的用处可多了。最常见的，当然是用来解释那些非自解释的代码块。比如，你实现了一个比较巧妙的位运算，或者一个涉及多线程同步的复杂逻辑，这时候不加个

/* */

登录后复制

详细说明，后面的人估计得抓耳挠腮。我遇到过不少代码，光看变量名和函数名根本猜不透其深意，这时候如果能有几段清晰的多行注释，那简直是救命稻草。

还有一种非常实用的场景，就是我前面提到的，临时注释掉一大段代码。这在重构、测试或者功能切换时特别有用。你可能在尝试两种不同的实现方案，或者需要回溯到某个旧版本的功能，直接用

/* */

登录后复制

圈起来，代码还在那里，但不会执行，方便你随时切换回来。

AssemblyAI

转录和理解语音的AI模型

查看详情

不过，用多行注释也有几点需要注意的。

别过度注释。有些代码本身就非常清晰，比如

int sum = a + b; // 计算a和b的和

登录后复制

，这种注释就显得多余了，反而会增加阅读负担。注释的目的是为了弥补代码在表达力上的不足，而不是重复代码本身。

注释内容要保持更新。这是个老大难问题。代码改了，注释没跟着改，那这注释就成了误导。我宁愿看到没注释的代码，也不想看到错误的注释。所以，每次修改代码，都要习惯性地检查一下相关的注释是否还需要调整。

再来，

/* */

登录后复制

注释是不能嵌套的。也就是说，你不能在一个

/* ... */

登录后复制

里面再写一个

/* ... */

登录后复制

。这会导致编译错误。如果你需要注释掉一段已经包含

/* */

登录后复制

注释的代码，通常的做法是使用IDE的“块注释”功能，或者直接使用单行注释

//

登录后复制

来覆盖整个区域。

除了基础的多行注释，Java还有哪些相关的注释方式？

Java在注释这块，其实挺周到的，除了咱们一直在说的

/* */

登录后复制

，它还有另外两种非常重要的注释方式，各自有其独特的用途。

最常见也是最基础的，就是单行注释

//

登录后复制

。这个大家应该都熟，从

//

登录后复制

开始到行尾，所有内容都是注释。它非常适合快速地给某一行代码做个简短的说明，或者暂时禁用一行代码。我平时写代码，用

//

登录后复制

的频率可能比

/* */

登录后复制

还要高，因为它轻量、灵活，适合即时性的标注。

而另一个重量级的选手，就是文档注释，也就是 Javadoc 注释 `/ */

**。这个跟

登录后复制

/ /

长得有点像，就多了一个星号。但它可不仅仅是多了一个星号那么简单，它的作用是用来生成API文档的。当你用

登录后复制

javadoc` 工具处理包含这种注释的源代码时，它能自动生成HTML格式的文档，清晰地展示你的类、方法、字段的功能、参数、返回值等等。

一个典型的Javadoc注释看起来是这样的：

/**
 * 这个方法用于计算两个整数的和。
 * 它会检查输入是否为负数，如果是，则抛出异常。
 *
 * @param a 第一个整数
 * @param b 第二个整数
 * @return 两个整数的和
 * @throws IllegalArgumentException 如果a或b为负数
 */
public int add(int a, int b) {
    if (a < 0 || b < 0) {
        throw new IllegalArgumentException("输入不能为负数");
    }
    return a + b;
}

登录后复制

你看，它里面可以包含