编码 GBK 的不可映射字符

snowolf

完善api-doc，用eclipse生成javadoc的时候发生“编码 GBK 的不可映射字符 ”，很是恼火。其实是字符编码问题。
打开eclipse，project -> Generate javadoc 一项一项的选你要输出javadoc的项目，在VM设置中加入以下代码-encoding utf-8 -charset utf-8
这次操作，输出的html代码不会发生“编码 GBK 的不可映射字符 ”问题，而且html字符编码都设为了UTF-8，问题彻底解决。
对应的ant target 如下
<target name="javadoc"><echo>+---------------------------------------------------+</echo><echo>|  Building Doc File                                |</echo><echo>+---------------------------------------------------+</echo><javadoc access="protected"         additionalparam="-encoding utf-8 -charset utf-8 "         author="true"         classpath="${classes.dir}"         destdir="${doc.dir}/api"         nodeprecated="false"         nodeprecatedlist="false"         noindex="false"         nonavbar="false"         notree="false"         packagenames="org.xxx.common.web.tag.go"         source="1.6"         sourcepath="${src.dir}"         splitindex="true"         use="true"         version="true"><link href="http://java.sun.com/javase/6/docs/api/" /></javadoc></target>

更为彻底的办法就是修改eclipse.ini文件，在末尾加入如下两行内容：
-Dfile.encoding=UTF-8-Dsun.jnu.encoding=UTF-8