cmd中利用javadoc命令生成API文档过程中编码问题-“编码GBK的不可映射字符”的解决方法

cmd中利用javadoc命令生成API文档过程中编码问题-“编码GBK的不可映射字符”的解决方法

1.情况介绍

javadoc命令怎么使用可以在命令行输入下面命令实现，也可以自行百度：

javadoc -help

我的java源程序以及包描述文件package.html都是使用记事本编写的，文件信息如下图所示，其中people和thing为两个包：

在chapter路径下输入：

javadoc -d apidoc -windowtitle 学校 -doctitle 学习javadoc的API文档 -header 我的类 -version -author people thing

稍微解释一下：
-d path 将生成API文档的放置在path路径下
-windowtitle text 用于设置API文档的浏览器窗口标题
-doctitle text 用于指定概述页面的标题
-header text 用于指定一个HTML格式的文本，该文本包含每个页面的页眉
-version 及-author则用于提取java源程序的标记信息包括@version、@author、@param、@return等

运行报错，报错图片如下所示
2.解决方法
从错误可以看出是编码的问题，javadoc默认编码是GBK编码，而我们的记事本默认编码是utf-8编码，所以根据文档注释生成API文档出现问题，我们可以改变javadoc的编码，也可以改变记事本的编码，使得它们编码一致，这里我采用的是第二种方法。
步骤如下图：

这里为啥是ANSI编码呢？这是因为在简体中文的windows系统中，ANSI编码代表的就是GBK编码。

3.改完之后的结果
这里可以看出包描述编码出了问题，这是因为包描述文件也需要改为ANSI编码，改完就可以看到如下结果了，这里需要注意浏览器的编码格式也得和这里一致，不然中文字符会乱码。