注释

单行注释：

//注释不参与编译

多行注释：

/ / 多行注释不可嵌套使用

文档注释（Java特有）

格式：/*
@author 指定java程序的作者
@version 指定源文件的版本
/
注释内容可以被JDK提供的工具 javadoc 所解析，生成一套以网页文件形式体现的该程序的说明文档。

正确的注释和注释风格

使用文档注释来注释整个类或整个方法。
如果注释方法中的某一个步骤，使用单行或多行注释。
正确的缩进和空白
使用一次tab操作，实现缩进
运算符两边习惯性各加一个空格。比如：2 + 4 * 5。

API

API （Application Programming Interface,应用程序编程接口）是 Java 提供的基本编程接口。
Java语言提供了大量的基础类，因此 Oracle 也为这些基础类提供了相应的 API文档，用于告诉开发者如何使用这些类，以及这些类里包含的方法。