如何用IDEA生成doc文档
JavaDoc可以将文档注释生成HTML文件,阅读起来很方便,像阅读Java的API一样。
文档注释规则为:
- @author 作者名
- @version 版本号
- @since 最早使用的JDK版本
- @param 说明一个方法的参数
- @return 说明返回值类型
IDEA生成JavaDoc文档:
当我们写完类和方法的文档注释后需要生成doc时可以直接使用IDEA的Generate JavaDoc
功能进行导出文档。
- 选择是整个项目还是模块还是单个文件
- 文档输出路径
- Locale 选择地区,这个决定了文档的语言,中文就是zh_CN
- 传入JavaDoc的参数
-encoding UTF-8 -charset UTF-8
控制台的输出内容:
![](https://cdn.nlark.com/yuque/0/2021/png/651635/1617105254250-3bd4a1a8-3af0-4400-b49d-1b05e662a772.png)
![](https://cdn.nlark.com/yuque/0/2021/png/651635/1617105342535-8bb3d0e2-a363-47d5-8e79-7631e8f1b14d.png)