注释简单的来说就是一种说明,不能被当成执行语句执行。做为一名程序员,但我们在写代码时是顺着思路写下去的。写代码好比就是在做题。当你在做的时候你脑海时的思路很清晰,会想到用一些特殊的方法来解决当前的问题。但是但你在解决一个大型问题时。思路有很多,而且有的比较复杂,现在你现写代码时,自己心里清楚自己为什么要这么写。但时隔几天或几个月,当你再次打开你所写的代码时。你会发现一大堆代码看下来整个人会晕头转向的。会忘记当时所写的部分代码的功能或实现过程。简单的说就是会忘记当时的思路。
创新互联公司主营丰都网站建设的网络公司,主营网站建设方案,成都app软件开发,丰都h5小程序设计搭建,丰都网站营销推广欢迎丰都等地区企业咨询
而这时注释的作用就显示十分重要了。当你在写代码时。写到关键部分你可以写下一些说明(注释),说明你的思路或此段代码的功能和作用。当有了这些说明,你时隔几个月再回来看自己曾经写的代码时就能快速找回当时的思路,快速理解代码。值得提的时。以后在工作上,往往是团队合作。今天你写了几个代码。明天可能你请假,另一个人来接手你的工作。接着你的代码写下去。但如果你写代码时用到了一些别人不知道的思路时。如果没有注释,别人根本就很难理解你的代码。也就难以接手你的工作了。
说以上这些只是为了让楼主能明白注释的重要性。好了。下面正面回答楼主的问题:
上面说到。代码中可以加以注释来说明自己所写的代码的作用。在Java中有单行注释,多行注释,和文档注释。
(1)单行注释:以“ // ”开头后面接所要加的说明的内容。如下面所示:
//定义变量a
int a = 10;
//定义变量b
int b = 20;
上面的语句中,在编译的过程就会直接略过注释,只会编译 int a = 10 和 int b = 20这两句。由此可见注释只是起着说明的作用。
(2)多行注释:以“/*”开头,以“*/”结尾。
假设当你要说明你所写的代码的功能时。要说明的内容有很多。如果全部放在同一行会显得很难看。所以一般会用多行来写,如下所示
// 说明
//说明
//说明
//说明
以上是用四个单行注释来注释四行说明。但如果有10行说明就要按十个“//”这显示很麻烦,所以这时就可采用多行注释。上面的可改成:
/*
说明
说明
说明
说明
*/
也可以这样
/* 说明
说明
说明
说明 */
(3)文档注释:以“/**”开头,以“*/”结尾。文档注释主要是生成文档的。楼主刚学Java可能不知道什么是API文档。因此,这里我就不说明了。以后你自然会明白。
好了就这些了。希望能帮到楼主,祝楼主学习愉快!O(∩_∩)O哈哈~
Java中三种类型的注释:
单行注释:// 注释内容
多行注释:/*... 注释内容....*/
文本注释:/**.. 注释内容....*/
代码注释是架起程序设计者与程序阅读者之间的通信桥梁,最大限度的提高团队开发合作效率。也是程序代码可维护性的重要环节之一。所以不是为写注释而写注释。
备注:简单的代码做简单注释,注释内容不大于10个字即可,另外,持久化对象或VO对象的getter、setter方法不需加注释。
扩展资料:
类(模块)注释采用 /** …… */,在每个类(模块)的头部要有必要的注释信息,包括:工程名;类(模块)编号;命名空间;类可以运行的JDK版本;版本号;作者;创建时间;类(模块)功能描述(如功能、主要算法、内部各部分之间的关系、该类与其类的关系等,必要时还要有一些如特别的软硬件要求等说明);主要函数或过程清单及本类(模块)历史修改记录等。
参考资料来源:百度百科-java注释
单行注释:
从“//”开始到行末结束,均视为单行注释。
多行注释:
从“/*”开始到“*/”结束,均视为多行注释。
文档注释:
从“/**”开始到“*/”结束,均视为文档注释。
文档注释与多行注释的区别:
文档注释可以用javadoc命令提取出来,生成类似于jdk文档的网页文件,以便于他人了解一个类的功能。