day01_Java语言概述/20-尚硅谷-Java语言基础-单行注释与多行注释

来，我们来学习注释，注释呢用英文叫comment啊，这再往后呢，我们会讲一个内容叫做注解，哎注解跟注释呢不一样啊，呃，注解呢叫annotation啊，到后边我们再说那个结构啊，先来看这个注释，呃，注释呢，其实简单来说就是对我们写的代码呢进行解释说明作用的。啊，那我们看看在Java当中啊，有哪些注释，Java呢规定了三种注释类型啊，第一种叫单行注释，第二种多行注释啊，第三个叫文档注释。啊，这有三种类型的注释，那我们呢，依次呢，对这三种注释呢进行说明，好，那咱们这呢，就不妨呢再去新建一个文件来进行说明了，啊首先找到咱们这个代码啊，我在D盘咱们code c0一下啊，在这个目录下呢，我去新建一个Java文件。啊，你看文新念他都给我差不多都写好了，都是吧。

啊，新个Java文件，这个呢，我们叫一个hello啊，我就叫hello Java啊这样啊呃这呢就涉及到我们这个代码的编写方式啊，你看它这个大括号呢，它是写在下一行的开头了啊，这就是有两种这个习惯，呃，如果你要是习惯呢，这样写，那就这样写，只不过呢，我不习惯这样写啊，我习惯呢，把这个大括号呢放在上一行的末尾，呃，这个叫这个叫什么行尾模式啊。哎，我习惯了这样去写。嗯，这是两种模式，这个Java的源码呢，其实跟我这种方式是一样的，嗯，所以大家呢，你想怎么写都可以啊呃，写完以后呢，咱们把这个文件呢，先保存一下吧。保存一下的话，点这个保存。哎，咱就存在这个对零一下啊，名字呢，嗯，跟那个名一样吧，诶，Hello，哎，我叫hello Java啊，然后保存一下啊可以了啊行，那现在的话呢，我们要讲一下这个注释啊，这个注释的话呢，CTRLS一下先啊，这是咱们刚才写好的，这样其实也没怎么写啊，就直接生成的时候，它就自带了这样一个程序了，只是把这个类名呢写了一下，那此时的话呢，其实我们就可以进行编译和运行了，先跑一下看看啊，在我们这个目录下，因为我们是在对零一下，这还在对零一下来Java c hello word啊hello不是word了，Hello java.java好编译，然后运行的话呢，因为我们生成的这个类名跟这个文件名是一样啊，你就接着Java，嗯，Hello Java回车，哎，Hello word这不就出来了。

他就他啊行，那接着呢，咱们来说一下这个注释的问题啊，注释的话呢，呃，首先提到一点，它就是对我们的这个程序呢，进行解释说明的，现在这里边除了代码没有别的东西了啊，那我们就进行解释说明，解释说明比如说这个大家也看到了啊，它这个写法我们这儿呢，可以加一对双斜线。

哎，这呢就是表示叫单行注释，哎，单行注释哎，我们保存一下，你看我加上这个双吸烟以后哈，它这个颜色这是绿色的啊CTRLS我们进行编译运行，你会发现呢，不受影响。啊，这个写的汉字文字就是让我们看的，如果你要是把这个双斜线去掉。这回什么情况？对，这样运行肯定就挂了。编译错了，你怎么分不出来几个汉字呢，是吧，那那言爱之意呢，你看我这是编译哈，我们编译的时候呢，如果你要是加上这一对双斜线叫单行注释的，它是不是就把这个内容给过掉了，哎，对，也就是说呢，我们这个单行注释呢，它是不参与你注释调的内容啊，它是不参与编译的。啊，不参与编译的，那这个呢，就是让我们看的啊，比如说单行注释下面我们说哎如下的语句，哎表示啊，就是输出到控制台的意思。

啊，表示输入到控制台啊，进行了一个解释说明，然后上面呢，这是一个may，它其实是我们Java中的一个方法。哎，而且呢，它还是一个特殊的方法，哎，大家也注意到我们编译的时候呢，不写may没事，运行的时候不写may，它就报错了，它其实是我们程序运行的一个入口啊，所以我们这样也加一个说明，叫单行注释啊，说如下的may方法。啊，是程序的入口。哎，这个哎双斜线，这就是表示叫单行注释进行解释说明的，哎，比较简单啊比较简单，那么除了这个单行注释之外呢，还有第二种叫做多行注释。

哎，如果你要想说的内容呢，这一行不能写太长啊是吧，你要写第二行其实还可以呢，再来一个单行也行，哎，我们说这个main方法，它的这个格式啊，是固定的啊，多说一句话也行。其实这样也行哈，但是你要说都老师家那个单行不好看，你可以使用一个多行注释这样来写，哎，在呃，这个你要注释的这个文字的前面一个单引号，然后后边呢，补一个星。然后呢，在这块呢，呃，一个星一个斜线，诶这样。在这个里边的内容啊，这都是多行注释。你看能看懂是吧，哎比较简单啊，哎，这是多行注释，这呢是单行注释啊CTRLS来我们跑一下啊先编译哎不会报错啊，那运行呢也不受影响。

哎，这个呢，就是让我们程序员来看的哈，哎，所以这块呢，我们在这块呢，写一个这个说明啊，说明呢，既然说明呢，也得是用这个，哎多行注释，我们来表示一下啊这样。首先第一个问题说张案呢，哎，规范了三种，哎注释方式，哎分别呢，单行注释，多行注释，文档注释啊，这是第一个问题啊，然后第二问题，哎第二问题呢，我们先主要呢，先来说一下这个单行和多行的啊，这个文档呢，我们一会再说那单行注释，多行注释，首先呢，大家要关注的就是他们的格式怎么去写。啊，这个格式呢，大家需要去掌握，包括多行，呃，文档呢，一会儿也得去掌握啊，格式呢，掌握了掌握以后呢，我们下边说一下这个单行注释和多行注释的作用。

哎，这个呢，肯定是我们比较关心的啊呃，作用的话呢，其实显而一是不是就是刚才提到了对我们所写的这个程序进行解释说明的作用啊，嗯，哎，这是第一个啊。对啊，所写的程序进行解释说明啊，那叫增强可读性。哎，增加可读性。就是你这个代码写的是什么意思啊，要做什么事啊，我通过单行和独行注释的方式呢，写出来，呃，这样的话呢，便于去呃别人理解，其实也不管别人理解了，也便于你自己去理解。啊，就是这个可读性解释说明给谁看的啊，这个方便自己，方便别人怎么理解啊。你就说，那就方便别人呗，怎么还方便自己呢？你以为你自己写的代码几个月以后再看就能看得懂吗？

你自己写代码，你过了几个月以后，有时候你看真的会出现你看不懂的，诶我当时为什么要加这段代码，是要做什么用的，这个变量是要干什么来着，你可能会迷糊，因为代码量呢也比较大了，就啊所以呢，我们写的这个代码，一方面呢，也是给自己看的，你定义这个变量要干什么用啊，说明一下啊，另外呢，就是这个项目呢，我们都是每个人开发一部分了，最后整合的时候，或者说呢，你这个项目后边要别人接手了，或者呢，你去接受别人的项目了，那你肯定要拿到他的代码，这里边呢，加上一些注释，这一定是必要的。啊，你要一行注释没有，那项目经理肯定得骂你啊，啊，那肯定不合适的啊，需要把必要的一些代码的注释要加上，这个注释呢，其实就跟大家买药的时候那个药的说明书一样啊，你要买药上面什么说明书也没有，也不知道怎么去吃，那你也不敢买是吧？哎，所以这个是必要的啊好，这是它的一个作用啊，然后呢，第二个作用，哎第二作用呢，就是我们可以对呃写的代码，其实一定程度上呢，可以进行调试啊，它有这样的一个作用啊，可以调试哎缩写的这个代码，哎这个怎么去理解啊，举一个例子啊，你看这呢，我写了一个输出语句叫ho word，我CTRLC一下，我再换行，再来一行。

啊，这个呢，咱们刚才没写过啊，大家能想象出来这个效果不？这个亚这样能理解吧。就是这个呢，叫print line LA一行的意思哈，所以这是一行，这是一行两行数据啊，这呢是一个正确的，那你要一不小心呢，上面忘了加这个分号了，这肯定PA就过不了了，这不就报错了吗。啊，那大家写程序的时候呢，如果说呃，你出现了一个错误，然后呢，你又不能确定，比如它是哪块出问题的，你就把其中的某一块呢给注释了，注释完以后你再去运行发现就没错了。

那是不是就有可能是你注释这块出问题了，对，可以呢，就是帮助我们去调试咱们所写的代码啊，帮助我们去调试缩写代码，实际上这个功能的实现呢，依赖于一个特点啊，啊依赖一个什么样的一个特点呢？就是我们的单行注释和多行注释呢，它是不是都不参与我们的编译啊。啊对啊，CTRLC啊，然后CTRLV单行注释和多行注释啊的内容啊，这个注释了的内容。啊不参与啊，这个编译啊，这个换句话说呢，就是啊，换句话说话说啊，就是我们编译以后，咱们会生成那个自解码文件啊，自解码文件当中是不包含这个和这个信息的啊，因为你没参与嘛，所以这个自解码文件里面根本就没有这些注释调的内容啊，啊不参与编译，换句话说呢，就是编译以后，呃，生成的啊点class结尾的S自解码文件。

中啊，不包含注释调的文字啊，或者注释调的清晰。哎，这个信息啊，行，这个太长了，以后我们可以诶换行一下啊。

嗯，这一下啊好，那这呢，就是我们说的这个叫单行注释和多行注式，这个大家写代码的时候呢，要诶要去用上它啊，就是写这个注释是一个良好的习惯啊，这个我们填一下。