javaSE基础知识 1.1代码注释

本人第一次写博客 但愿大牛多多关照 若是有不对的地方请大牛指出  

本文章将会持续更新直到SE基础结束为止

前面JDK安装和Eclipse安装请百度查找进行下载，这里JDK推荐1.8版本，1.8版本是一个已经完善的版本，安全性较高，1.8以后的版本也是基于1.8版本进行再次开发和拓展。

这个是JDK1.8的下载地址

https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

这个是Eclipse的下载地址

https://www.eclipse.org/downloads/

代码的注释与编码规范

下面咱们来说一下代码的注释与编码的规范由于合理的注释和编码规范能够为以后团队等我的开发和维护时提供很好的方便

经过在代码中添加注释能够提升代码的阅读性能够帮助程序员更好的阅读代码 其中代码是让计算机识别的 例以下面这段代码

上面这段代码就是给计算机阅读的，计算机会将咱们写的代码转化成计算机能够识别的字节码，就向这样1010的字节码

其实呢，咱们写的代码是给程序员看的，因此呢程序员写的代码不只要计算机能读你的程序，也须要其余程序员能读懂你的程序，若是你开发时看到的是这样的代码，或者你让其余人看你写的这段代码，无论哪一个人是不是初学者或者工做不少年，当他看到这段代码的第一感受确定会疯掉的

可是若是咱们给这段代码加上注释再给别人看的话，这时就一目了然了，这些代码的每一行做用以及后期维护都带来方便

有的初学者就会感受，我本身写的代码我本身看懂就好了，其实这是一个致命的错误，若是你写的代码不加注释过了1个月，2个月，再让你看这些代码时你确定会说当时本身写的是什么鬼，在公司开发过程当中，开发人员和维护人员是分工协做的，当你写的代码乱糟糟的后期维护人员，维护时确定会疯掉的，因此注释是必不可少的

注释是个好东西

注释就是对代码的解释和说明，对每一处重要的代码都要加一处注释，其中有的人会担忧本身的代码有注释会不会运行，放心，注释范围内的任何东西都不会被计算机进行编译执行

注释的三个种类

// 这种叫作单行注释，这两个//以后的东西都不会被计算机进行编译执行
复制代码

/*  
 这种叫作多行注释，在两个/*之间的内容都不会被计算机进行编译执行
*/复制代码

/**
* 这种叫作文档注释，文档注释通常对类中的方法和类进行文档注释，它也是一种多行的注释
*/复制代码

这三种注释中，咱们最经常使用的呢就是前两种注释，单行注释和多行注释，这两种注释呢是帮助咱们调试程序，添加解释说明的，第三种文档注释是帮助咱们生成帮助文档的

下面咱们来看看这三种注释，

这里用了单行注释就只输出了5行 下面来看看多行注释

这里只输出了3行 下面来看看文档注释

这里呢，这个注释是对这个类进行注释说明，当实例化调用这个类时就会提示所说明的做用，方法上面的文档注释是对方法进行注释说明