关于java的注释

Java编程中的注释类型与颜色管理
本文介绍了Java编程中注释的重要性,包括单行注释、多行注释(避免嵌套)和文档注释的使用,以及如何在Idea开发工具中修改注释颜色。

Java中关于注释的说明

一、了解注释

  • 注释在代码中具有很重要的作用,在最初开始写代码的时候,不书写注释自己还可以记得住自己写的代码是什么含义,但是慢慢的,代码越写越多,没有注释,回头看看自己写过的代码,很难记起当时这个方法的作用,或者声明的是什么,所以写注释是一个非常好的习惯,也是对代码起到规范作用😊

  • 注释也可以用来,如果写了一段代码,想要换一种方法,还不想删除原来的方法,就可以将原有的方法进行注释掉,代码不会编译运行注释部分的文字或者代码!

二、注释的三种类型

  • 单行注释

用上一篇文章中的Hello,World!进行说明

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

单行注释书写为两个//,后边加上要注释的内容即可。

  • 多行注释
public class Hello{
    public static void main(String[] args){
        System.out.println("Hello,World!");
        /*System.out.println("Hello,World!");
        System.out.println("Hello,World!");
        System.out.println("Hello,World!");
        System.out.println("Hello,World!");*/
    }
}

多行注释书写为/**/(两个星号中间的部分为被注释部分)。

多行注释不要去嵌套!!

因为/**/是一个首位符号,如果嵌套的话,首符号会自动匹配第一个尾符号进行注释,下面举例说明一下。

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

像这样,大家就可以看到,中间有一部分没有被注释掉,因为首符号只会去找第一个匹配上的尾符号,所以会导致漏掉想要注释的部分。

  • 文档注释
/**
*@author落满樱花的羊
*@Version 01
**/
public class Hello{
    public static void main(String[] args){
        System.out.println("Hello,World!"); 
    }
}

文档注释书写为/** **/ 选中中间部分按回车会自动换行,不用去每一行去注释,这种注释在平时写代码中不是很常用,上述中,可以在文档注释中写作者名字,版本号等信息。

三、注释的颜色

本人用的是Idea开发工具,注释的默认颜色是绿色,大家可以根据自己喜欢的颜色,去开发工具中修改。

可以参考一下大佬的博客

Idea修改注释文本颜色

如果是使用其他开发工具的也可以去网页搜索修改教程,怎样修改美观等😀

Java注释是为了提供文件、方法、数据结构等的意义与用途的说明,或者算法的描述,不会出现在HTML报告中。以下是关于Java注释的使用方法、类型及规范的详细信息: ### 使用方法 注释可以位于一个文件或者一个方法的前面,起到引导的作用,也可以根据需要放在合适的位置。 ### 类型 - **域注释**:注释若干行,一般用于描述文件、方法、数据结构等的意义与用途,或者算法的描述。注释格式通常写成:`/* * 注释内容 */`[^1]。 - **文档注释**:通过特定的标签提供更详细的信息,这些标签在生成文档时会被解析。常用标签及用途如下: - `@see`:生成文档中的“参见xx的条目”的超链接,后边可以加上:“类名”、“完整类名”、“完整类名#方法”。可用于类、方法、变量注释[^2]。 - `@param`:用于方法注释,对方法的参数进行说明[^2]。 - `@return`:用于方法注释,对方法的返回值进行说明[^2]。 - `@exception`:用于方法注释,说明方法可能抛出的异常[^2]。 - `@version`:用于类注释,提供类的版本信息[^2]。 - `@author`:用于类注释,指明类的作者名[^2]。 - `@deprecated`:对类或方法进行说明,表明该类或方法不建议使用,会引起不推荐使用的警告[^2]。 - `@note`:表示注解,暴露给源码阅读者的文档[^2]。 - `@remark`:表示评论,暴露给客户程序员的文档[^2]。 - `@since`:表示从哪个版本起开始有了这个函数[^2]。 ### 规范 以下是一个类注释的示例,展示了规范的注释写法: ```java /** * Title: XXXX DRIVER 3.0 * Description: XXXX DRIVER 3.0 * Copyright: Copyright (c) 2003 * Company:XXXX有限公司 * * @author Java Development Group * @version 3.0 */ ``` 在方法注释中,规范使用`@param`、`@return`、`@exception`等标签,示例如下: ```java /** * 计算两个整数的和 * * @param a 第一个整数 * @param b 第二个整数 * @return 两个整数的和 * @exception ArithmeticException 如果计算过程中出现算术错误 */ public int add(int a, int b) { return a + b; } ```
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值