不少初学java开发的朋友,常常为找不到最新版开源项目的离线帮助文档而困扰,比如java官方api的chm格式文档,或是hadoop等框架的chm版api手册。本文将介绍一种高效可行的方式——利用工具自行将html格式的官方api文档打包成chm文件,实现本地快速查阅,显著提高学习与开发过程中的信息获取效率。
1、推荐使用javadoc2chm这款轻量级转换工具,只需在百度中搜索“javadoc2chm”即可找到下载资源。部分网站提供该工具下载,标价为1积分;本人也存有可用版本,如有需要可私信联系获取。

2、注意:javadoc2chm.exe 文件体积仅约102KB,异常精简,务必提高安全意识,谨慎甄别来源,避免下载到被篡改或植入恶意代码的仿冒版本。

3、大多数主流开源项目(如Struts2)发布的二进制包中,通常已内置完整的HTML格式API文档,一般位于解压后的doc目录下,这类结构规范的HTML文档可直接作为javadoc2chm的输入源。

4、启动javadoc2chm.exe后,界面包含三个关键配置项:“path to javadoc”用于指定原始HTML文档根路径;“output filename”填写输出CHM文件名,必须以“.chm”结尾;“title”则设定CHM打开后首页顶部显示的标题文字。

5、以Hadoop 2.7.1为例:选中其hadoop-common-project/hadoop-common/src/main/docs/api(或对应发行包中的docs/api)目录后,点击Go按钮即开始编译。生成成功后,按钮会变为黑色状态,表示可重复操作;最终生成的CHM文件将自动保存于所选HTML文档所在目录中。



















