java 生成javadoc文档，怎么总报错

Posted 2023-04-04

参考技术A 用eclipse导出工程的doc文档，发生编码 GBK 的不可映射字符的错误，这是由于java源代码文件为utf-8编码，源代码中的doc注释喊中文。生成文档时就可能会出现该错误。解决方法：
Export后进入javadoc Generate 时， 点“next”进入第三个对话框时，在"Extra Javadoc options" 文本框里面加上 “-encoding UTF-8 -charset UTF-8”，如图：

2.出现“非法字符：\65279”的解决方法
一般用UE或记事本编辑过的UTF-8的文件头会加入BOM标识，该标识由3个char组成。在UTF－8的标准里该BOM标识是可有可无的,Sun 的javac 在编译带有BOM的UTF-8的格式的文件时会出现“非法字符：\65279”的错误。
用UE等打开该java源文件，另存为无BOM的utf-8格式。
3.如果没报任何错误但是不显示注释 则和1.的解决办法一样本回答被提问者和网友采纳

如何在eclipse中，为整个工程生成javadoc文档

　　1. 在项目列表中按右键，选择Export（导出），然后在Export(导出)对话框中选择java下的javadoc，提交到下一步。
　　在Javadoc Generation对话框中有两个地方要注意的：
　　javadoc command:应该选择jdk的bin/javadoc.exe
　　destination:为生成文档的保存路径，可自由选择。
　　按finish(完成)提交即可开始生成文档。
　　2. 用菜单选择：File->Export(文件－>导出)，
　　剩下的步骤和第一种方法是一样的。
　　3. 选中要生成文档的项目，然后用菜单选择，
　　Project->Generate Javadoc直接进入Javadoc Generation对话框，剩余的步骤就和第一种方法在Javadoc Generation对话框开始是一样的。
　　
　　用哪种方法都行，但是要注意一下几个问题：
　　1、eclipse不能生成，报错：
　　java.lang.IllegalArgumentException at sun.net.www.ParseUtil.decode
　　，这是由于设置java环境变量引起的。例如classpath为
　　.;%JAVA_HOME\\lib\\dt.jar;%JAVA_HOME%\\lib\\tool.jar，解决方法就是把classpath删除或是参考官方文档 http://maven.apache.org/plugins/maven-javadoc-plugin/faq.html 。
　　2、生成文档乱码问题。完善api-doc，用eclipse生成javadoc的时候发生“编码 GBK 的不可映射字符 ”其实是字符编码问题。打开eclipse，project -> Generate javadoc 一项一项的选你要输出javadoc的项目，最后一步中VM设置行中加入以下代码 参考技术A 选中项目右键export----java----javadoc