Java 文档注释：注意与建议：💬面试怎么答

💬面试怎么答

• 问「注释有几种」：
• // 单行、/* */ 多行、/** */ 文档注释；
• 只有文档注释能被 javadoc 提取生成 API 文档；
• 注释不参与编译，不影响程序运行。

⚙️javadoc 命令怎么用

• 在源文件目录执行：
• javadoc -d doc SquareNum.java
• -d 指定输出目录；
• 加 -author -version 才会输出作者与版本；
• 生成结果打开 index.html 即可。

ShellCmd.java

• # 生成带作者与版本的文档
• javadoc -d doc -author -version SquareNum.java
• # 一次生成整个包
• javadoc -d doc -author -version com.example.*
• # 指定编码，避免中文乱码
• javadoc -d doc -encoding UTF-8 -charset UTF-8 SquareNum.java