Java——语法知识

一、注释（Comment）

注释可以提高代码的可读性，是一个很好的编程习惯。注释不会被 JVM 解释执行。Java中的注释有三种：

1、单行注释

单行注释在 Java 中由 // 开始，注释内容从 // 开始直到这一行的末尾。单行注释一般用于对单行代码进行简要说明，或者临时注释掉某行代码。

	//这是一个注释示例
	int a = 0;//这是一个注释示例

2、多行注释

多行注释在 Java 中由 /* 开始，并以 */ 结束，可以跨越多行。这种注释一般用于对一段代码块进行说明，或者临时注释掉多行代码。

/*这是一个多行注释示例
这是一个多行注释示例*/

多行注释中不能嵌套多行注释，就像下面这样，是错误的：

/*这是一个多行注释示例
这是一个多行注释示例

	/* 嵌套多行注释是错误的

	*/

*/

可以发现这里的最后一个 */ 都没有被解释为一个注释，实际上注释在第一个 */ 就结束了。后面的就不是注释内容，如果运行这段代码，就会出现报错。

3、文档注释

文档注释在 Java 中由 /** 开始，并以 */ 结束。这种注释主要用于描述类、接口和方法，并且可以被 Javadoc 工具解析成 API 文档。文档注释通常用于提供更加详细的注释信息，包括参数描述、返回值描述、异常说明等。

Javadoc 注释的常用标签：

• @param：描述方法的参数
• @return：描述方法的返回值
• @throws 或 @exception：描述方法可能抛出的异常
• @see：提供相关主题的参考链接
• @since：标识自哪个版本开始加入的功能
• @deprecated：标识该方法或类已经不推荐使用

可以通过 javadoc 指令来自动生成详细的 HTML 文档。

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

使用 -d 参数指定路径，使用 -author 指定生成作者信息，使用 -version 指定生成版本信息。

二、Windows的dos指令

1、cd

我们知道 cd 指令可以更换目录，但是如果我们想要从 D 盘切换到 C 盘呢，也就是切换驱动器，就需要一个参数：/d。就像下面这样：

如果你希望直接切换到 C 盘的某个特定目录，可以使用 /d 参数。例如：

cd /d C:\Path\To\Directory

这将会切换到 C 盘，并进入指定的目录。

实际上还可以直接输入目标盘符，例如：

C:

这将会切换到 C 盘，并切换到你上次在 C 盘所在的目录。

2、tree

tree 命令是在 Windows 命令行中用来以树状结构显示目录和子目录的结构图。它提供了一种直观的方式来查看文件系统的层次结构。

tree [drive:][path] [/f] [/a]

• [drive:][path]：指定要显示的驱动器或路径。如果未指定，tree 将从当前目录开始显示。
• /f：显示每个文件而不仅仅是目录。
• /a：使用 ASCII 字符而不是扩展字符来显示树形结构。这在某些字符集或远程连接中可能更容易阅读。

示例：