eclipse中使用ant時，報錯 編碼 GBK 的不可映射字符

轉自http://snowolf.iteye.com/blog/229307，能解決問題。

完善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