如何使用 idea 生成javadoc 文档
1、打开 idea,点击 Tools-> Generate JavaDoc,这样会打开生成 javadoc 文档的配置页面。
2、就可以进行配置:
标注的是重要的部分,从上往下分别是配置 javadoc 的范围,输出文件夹路径以及命令行参数。
这里的命令行参数很重要,因为只有使用 utf-8 编码才能保证生成时可以正常处理中文字符,所以一定要加上:
-encoding utf-8 -charset utf-8
还可以配置那些注解需要生成,哪些权限类(private、package、protected、public)需要生成等等精细的控制。
还有一点需要注意,即不要勾选“Include test sources”,勾选后,生成时会造成一些很奇怪的错误。
3、配置好后,点击生成按钮,生成好后就会自动在浏览器打开进行查看了