1. 先搞清楚CHM到底是个什么东西CHM这三个字母全称是Compiled HTML Help翻译过来就是“编译后的HTML帮助文件”。微软在九十年代末推出这个格式本意是给Windows应用程序做离线帮助文档用的。它把一堆HTML页面、图片、CSS样式表、甚至JavaScript脚本全部打包压缩进一个单一文件里再用一个索引系统把它们串起来。你可以把它理解成一本自带目录和搜索功能的电子书只不过这本书的排版语言是网页那一套。我第一次接触CHM大概是十几年前当时下载了一个开发工具的离线文档双击打开之后左边是树形目录右边是内容区域顶部还有搜索框和前进后退按钮。那个体验在当时来说相当惊艳因为整个文件才几兆大小却装了几百页的内容而且不需要联网就能全文检索。后来我才知道CHM内部用的是LZX压缩算法压缩率相当高再加上HTML本身是文本格式所以体积控制得非常好。这个格式最大的优势有三个。第一是单文件便携不管你是拷到U盘里还是通过邮件发给别人一个文件就搞定不会出现“图片丢失”“样式错乱”这种问题。第二是离线可用所有内容都在本地没有网络也能正常浏览和搜索。第三是制作成本低只要你懂一点HTML就能用工具把网页打包成CHM。正因为这些特点CHM在软件文档、技术手册、电子书、教程合集这些场景里被广泛使用。不过CHM也有它的问题。它是微软的专有格式在Windows上原生支持但到了macOS或者Linux上就没那么方便了。而且CHM文件本身可以内嵌脚本这就带来了一些安全隐患所以很多邮件系统会直接拦截CHM附件。另外随着在线文档和PDF的普及CHM的使用频率确实在下降但存量文件依然巨大尤其是在一些传统行业和旧版软件的文档包里你经常能碰到它。提示如果你手头有一个CHM文件但不知道怎么处理先别急着删。它的内容往往比你在网上能找到的版本更完整尤其是那些已经停止维护的软件文档。2. 打开CHM文件的几种靠谱方式2.1 Windows系统下的原生打开方法在Windows上打开CHM是最省事的因为系统本身就内置了支持。你只需要双击文件系统就会调用hh.exe这个程序来渲染内容。这个程序从Windows 98时代就存在了一直保留到现在。打开之后你会看到一个标准的帮助窗口左侧是目录树右侧是内容区顶部有隐藏/显示目录的按钮、前进后退、主页、打印、搜索等常用功能。但这里有一个非常常见的坑很多从网上下载的CHM文件双击之后右侧内容区显示“已取消到该网页的导航”或者一片空白。这不是文件损坏而是Windows的安全机制在作祟。因为CHM文件可能包含恶意脚本所以系统会对来自网络的文件加一个“锁定”标记。解决办法很简单右键点击CHM文件选择“属性”在“常规”选项卡底部你会看到一个“解除锁定”的复选框勾上它再点确定重新打开就能正常显示了。还有一个情况是打开之后左侧目录正常但点击任何条目右侧都提示“无法显示此页”。这通常是因为文件路径里包含了中文或者特殊字符或者文件被放在了网络共享路径下。把CHM文件复制到本地硬盘的一个纯英文路径下比如D:\docs\再打开基本就能解决。2.2 macOS和Linux上的替代方案macOS从很早的版本开始就不再原生支持CHM了。如果你在Mac上双击一个CHM文件系统可能会提示你选择打开方式但找不到合适的程序。这时候你需要借助第三方工具。我试过几个比较推荐的是CHM Reader和Clearview。前者是一个轻量级的阅读器界面简洁支持目录导航和全文搜索后者功能更全一些支持标注和书签但界面稍微老旧一点。安装方式也很简单下载dmg文件拖到Applications文件夹就行。打开之后如果遇到乱码大概率是编码问题。CHM内部的HTML页面可能用的是GBK或者GB2312编码而阅读器默认用UTF-8去解析就会显示成乱码。你可以在阅读器的偏好设置里手动指定编码为GBK试试。Linux上的选择就更少了。有一个叫xCHM的工具可以通过包管理器安装比如在Ubuntu上执行sudo apt install xchm。它的功能比较基础但应付日常阅读足够了。如果你不想装额外软件还有一个办法是用7z命令把CHM解压出来。CHM本质上是一个压缩包7z x filename.chm就能把里面的HTML文件全部提取到一个文件夹里然后用浏览器直接打开index.html或者toc.html。这个方法虽然原始但胜在通用任何系统上只要有7z就能用。2.3 手机端能不能看CHM手机上原生支持CHM的应用非常少。Android平台有一个叫CHM Reader的App界面比较简陋但能用。iOS上就更少了我试过几个都不太理想要么是广告太多要么是打开大文件就崩溃。如果你真的需要在手机上看CHM我的建议是先在电脑上把它转成PDF或者EPUB然后再传到手机上看。转换方法后面会详细讲。注意不管用什么工具打开CHM如果文件来源不明最好先在虚拟机或者沙箱环境里打开确认安全之后再在主力机器上操作。CHM内嵌脚本的能力是一把双刃剑。3. 把CHM转换成其他格式的完整实操3.1 为什么需要转换CHM虽然方便但它的局限性也很明显。首先是跨平台支持差你发给一个用Mac的同事他可能折腾半天也打不开。其次是编辑困难CHM是编译后的格式你想改里面一个错别字不能直接编辑得先反编译再重新编译。再次是打印和批注不方便虽然CHM阅读器一般都有打印功能但排版效果往往不尽如人意。最后是长期保存的考虑CHM是专有格式未来某一天微软彻底放弃支持也不是不可能而PDF和EPUB是开放标准保存年限更长。所以把CHM转换成PDF、EPUB或者纯HTML是一个很实际的需求。下面我分场景来讲具体的操作方法。3.2 转换成PDF的两种实用方案方案一用虚拟打印机。这是最简单的方法不需要安装任何额外软件。在Windows上打开CHM文件然后按CtrlP调出打印对话框在打印机列表里选择Microsoft Print to PDF然后点击打印。系统会让你选择保存路径确认之后就会生成一个PDF文件。这个方法的优点是操作极其简单缺点是它只能打印当前页面不能一次性把整个CHM的所有页面都打印出来。如果你要转换的CHM页面不多比如就十几页那这个方法完全够用。但如果是有几百页的大文件一页一页打印会让人崩溃。方案二先反编译再合并。这个方法稍微复杂一点但可以一次性处理整个CHM。首先用7z把CHM解压到一个文件夹里你会看到一堆.html文件和资源文件夹。然后你需要一个工具把这些HTML按顺序合并成一个PDF。我常用的是wkhtmltopdf这个命令行工具它可以把HTML渲染成PDF而且支持目录和页码。基本用法是wkhtmltopdf --enable-local-file-access toc.html output.pdf其中toc.html是CHM的目录页。不过实际操作中你会发现CHM的HTML文件之间的链接关系比较复杂直接合并可能会丢失导航结构。更稳妥的做法是先用一个脚本把HTML文件按目录顺序整理好生成一个总目录页再用wkhtmltopdf转换。如果你不想碰命令行还有一个图形化工具叫CHM to PDF Converter界面很直观选好输入文件和输出路径点一下转换就行。不过这类工具大多是收费的免费版会有页数限制或者水印。我个人的建议是如果只是偶尔转一两个文件用虚拟打印机就够了如果经常需要处理CHM花点时间学一下wkhtmltopdf的命令行用法会更高效。3.3 转换成EPUB的流程EPUB是电子书的标准格式在手机和平板上阅读体验很好。把CHM转成EPUB核心思路是先把CHM反编译成HTML再把HTML重新打包成EPUB。这里推荐一个工具叫Calibre它是一个功能非常强大的电子书管理软件内置了格式转换功能。具体操作步骤是这样的先用7z把CHM解压到一个文件夹然后在Calibre里点击“添加书籍”选择解压出来的index.html或者toc.html。Calibre会把它识别为一本书然后你点击“转换书籍”在输出格式里选择EPUB再点确定。Calibre会自动处理章节划分、目录生成、图片嵌入这些事情。转换完成之后你可以用Calibre自带的阅读器预览效果如果目录层级不对可以在转换设置里手动调整“目录”选项。这里有一个细节需要注意CHM里的HTML文件可能引用了外部CSS和图片解压之后这些资源的相对路径可能会变。Calibre在转换时一般能自动处理但如果发现样式丢失你需要检查一下HTML文件里的link和img标签的路径是否正确。有时候CHM里的路径用的是反斜杠\而Calibre期望的是正斜杠/手动替换一下就能解决。3.4 直接提取为纯HTML网站如果你想把CHM的内容放到网上或者内网服务器上供多人访问那直接提取为HTML是最合适的。用7z解压之后你会得到一个完整的静态网站结构。但直接打开index.html可能会发现左侧目录树不工作因为CHM的目录树通常是用一个特殊的ActiveX控件或者JavaScript实现的脱离CHM环境之后这些功能会失效。解决办法是找一个替代的目录导航方案。最简单的是用iframe做一个左右分栏的页面左边放一个自己生成的目录列表右边用iframe加载内容页。你可以写一个简单的脚本遍历所有HTML文件提取它们的标题生成一个嵌套的ul列表。这个脚本用Python写也就二三十行的事情。如果你不想写代码也有一些现成的工具比如CHM Decoder它可以在解压的同时生成一个兼容现代浏览器的目录导航。提示提取出来的HTML文件里可能包含一些CHM特有的object标签或者ms-its协议链接这些在普通浏览器里是无法识别的。你可以用文本编辑器的批量替换功能把这些标签清理掉或者替换成普通的a链接。4. 自己动手制作一个CHM文件4.1 制作CHM的准备工作制作CHM其实比很多人想象的要简单。你不需要什么昂贵的软件只需要准备好HTML内容和一个编译工具。HTML内容可以是手写的也可以是用工具从Markdown或者Word转换过来的。关键是要有一个清晰的目录结构因为CHM的导航树就是根据这个结构生成的。你需要准备的东西包括一个文件夹里面放所有的HTML文件、图片、CSS文件一个.hhp项目文件用来告诉编译器哪些文件要打包、首页是哪个、目录结构是怎样的一个.hhc目录文件定义左侧导航树的层级还有一个.hhk索引文件定义关键词索引。这三个文件都是纯文本格式用记事本就能编辑。编译工具方面微软官方提供了一个叫HTML Help Workshop的免费工具虽然界面老旧但功能完整。下载安装之后打开它新建一个项目按照向导一步步操作就行。如果你不想用这个老古董也有一些第三方的命令行工具比如chmcmd它是Free Pascal项目的一部分跨平台支持比较好。4.2 编写HHP项目文件的关键参数.hhp文件是整个项目的核心配置文件它决定了编译出来的CHM长什么样。我拿一个实际用过的配置来举例说明[OPTIONS] Compatibility1.1 or later Compiled filemyhelp.chm Contents filemyhelp.hhc Index filemyhelp.hhk Default topicindex.html Display compile progressYes Full-text searchYes Language0x804 中文(简体) Title我的帮助文档 [FILES] index.html chapter1.html chapter2.html images/logo.png styles/main.css [INFOTYPES]这里有几个参数值得展开讲。Compiled file指定输出的CHM文件名。Default topic是打开CHM时默认显示的页面。Full-text searchYes开启全文搜索功能这个非常实用建议一定要打开。Language指定语言代码0x804代表简体中文设置正确之后搜索和排序才会符合中文习惯。[FILES]段列出所有需要打包的文件注意路径要用相对路径而且分隔符用反斜杠。一个常见的坑是文件路径里包含空格或者中文。虽然CHM规范理论上支持但实际编译时经常出问题。我的经验是所有文件名和路径都用纯英文小写字母加数字不要有空格用下划线或者短横线代替。这样能避免百分之九十的编译错误。4.3 生成目录树和索引.hhc文件定义了左侧的目录树结构。它的格式是HTML的ul和li嵌套但用object标签来指定每个条目的名称和链接。比如!DOCTYPE HTML PUBLIC -//IETF//DTD HTML//EN HTML HEAD meta nameGENERATOR contentMicrosoft HTML Help Workshop /HEAD BODY UL LIOBJECT typetext/sitemap param nameName value第一章 概述 param nameLocal valuechapter1.html /OBJECT UL LIOBJECT typetext/sitemap param nameName value1.1 背景介绍 param nameLocal valuechapter1.html#section1 /OBJECT /UL /UL /BODY /HTML这个结构看起来有点啰嗦但逻辑很清晰。每个OBJECT代表一个目录条目Name是显示的文字Local是链接的目标。嵌套的UL表示子层级。你可以手动写这个文件也可以用工具自动生成。如果HTML文件很多手动写会非常痛苦建议写一个脚本从HTML的h1到h3标签里提取标题和锚点自动生成.hhc文件。.hhk索引文件的格式类似但它是用来做关键词索引的。每个条目包含一个关键词和对应的链接。用户可以在搜索框里输入关键词然后从索引列表里跳转到对应页面。这个功能对于技术文档特别有用因为用户往往想直接查某个函数名或者参数名。4.4 编译与调试配置文件和内容都准备好之后就可以编译了。如果用HTML Help Workshop点击“编译”按钮就行。如果用命令行工具执行hhc myhelp.hhp。编译过程中如果出错工具会给出具体的错误信息比如“文件未找到”“链接无效”之类的。根据提示逐个修复就行。编译成功之后双击生成的CHM文件检查以下几个方面目录树是否正常显示点击每个条目是否能正确跳转全文搜索是否能返回结果图片和样式是否正常加载。如果发现某个页面显示空白大概率是路径问题检查.hhp文件里的[FILES]段是否包含了那个文件。还有一个容易忽略的点是CHM的窗口样式。你可以在.hhp文件的[WINDOWS]段里定义窗口的大小、位置、是否显示导航面板等。比如[WINDOWS] main我的帮助文档,myhelp.hhc,myhelp.hhk,index.html,index.html,,,,,0x23520,,0x384e,,,,,,,,0这一长串参数看起来吓人但常用的就前面几个窗口标题、目录文件、索引文件、默认页面、主页。后面的参数控制按钮显示和窗口样式不设置也能用默认值。注意编译CHM时如果HTML文件里引用了外部网络资源比如CDN上的CSS或者字体编译出来的CHM在离线环境下会加载失败。所有资源都要本地化这是制作CHM的铁律。5. 常见问题与排查技巧实录5.1 打开CHM时提示“导航已取消”或内容空白这是最高频的问题没有之一。根本原因是Windows对来自网络的文件加了安全锁定。解决办法就是右键属性解除锁定。但有时候你解除了锁定换一台电脑又出现同样的问题。这是因为锁定信息是存在文件本身的备用数据流里的拷贝到其他电脑时如果用了不支持备用数据流的文件系统比如FAT32锁定信息可能会丢失但也可能被重新加上。如果你经常需要分发CHM文件可以在编译时就在.hhp文件里加上Binary IndexNo这样编译出来的CHM不会包含索引二进制数据减少被安全软件误判的概率。另外把CHM文件打包成ZIP再分发用户解压之后一般就不会被锁定了。5.2 目录树显示乱码这个问题通常出现在非中文Windows系统上打开中文CHM时。原因是CHM内部的目录树数据用了特定的编码而系统默认的语言设置不匹配。解决办法是在控制面板的“区域和语言选项”里把“非Unicode程序的语言”设置为中文简体。这个设置需要重启才能生效。如果你不想改系统设置也可以用7z把CHM解压出来找到.hhc文件用记事本打开另存为UTF-8编码然后再重新编译成CHM。不过这个方法比较绕适合对CHM结构比较熟悉的人。5.3 全文搜索失效CHM的全文搜索依赖于编译时生成的索引文件。如果编译时没有勾选Full-text search或者索引文件损坏搜索功能就会失效。检查.hhp文件里是否有Full-text searchYes这一行。另外如果CHM文件被部分损坏搜索索引也可能读不出来。这时候只能重新编译或者找原始文件重新下载。还有一个情况是搜索能返回结果但点击结果跳转不到正确页面。这通常是因为HTML文件里的锚点名称和索引里记录的不一致。检查一下.hhk文件里的Local参数是否包含了正确的锚点名称。5.4 制作CHM时编译报错“文件未找到”这个错误的根源几乎总是路径问题。CHM编译器对路径的容忍度很低不支持绝对路径不支持..上级目录引用不支持中文路径不支持空格。所有文件必须放在.hhp文件所在目录或者其子目录下路径用反斜杠分隔文件名用纯英文。我踩过的一个坑是在.hhp的[FILES]段里写了images\logo.png但实际文件夹名字是Images大小写不一致。Windows文件系统不区分大小写但CHM编译器区分。改成完全一致之后问题解决。所以建议所有文件夹和文件名统一用小写避免这种低级错误。5.5 CHM文件太大导致打开缓慢CHM的LZX压缩率很高但解压需要时间。如果一个CHM文件超过50MB打开时可能会有明显的卡顿。优化方法有几个一是压缩图片把BMP转成JPG或者PNG把PNG用工具再压缩一遍二是合并CSS和JavaScript文件减少HTTP请求数虽然CHM是本地文件但每个外部文件都要单独解压三是拆分CHM把一个大文件拆成几个小文件比如按章节拆分。还有一个技巧是在.hhp文件里设置CompressYes这是默认开启的。如果你发现编译出来的CHM比预期大很多检查一下是不是有些没用的文件也被打包进去了。[FILES]段里只列出真正需要的文件不要用通配符把整个文件夹都包进去。5.6 快速排查表问题现象最可能原因解决方法打开后内容区空白文件被锁定右键属性解除锁定目录树乱码系统语言不匹配修改非Unicode程序语言设置搜索无结果未开启全文搜索重新编译并勾选Full-text search编译报错文件未找到路径大小写或分隔符错误统一小写用反斜杠图片不显示资源未打包或路径错误检查[FILES]段是否包含图片打开速度慢文件过大压缩图片拆分文件跳转链接失效锚点名称不匹配检查hhc/hhk文件中的Local参数提示遇到任何CHM相关的问题第一步永远是用7z把它解压出来看看内部结构。大部分问题在解压之后都能一目了然。6. 一些进阶玩法和个人经验6.1 用脚本批量处理CHM文件如果你手头有几十个CHM文件需要转换或者提取内容一个个手动操作太慢了。我写过一个Python脚本用subprocess调用7z批量解压然后用BeautifulSoup解析HTML提取正文最后输出成Markdown或者纯文本。核心代码大概是这样import subprocess import os from bs4 import BeautifulSoup def extract_chm(chm_path, output_dir): subprocess.run([7z, x, chm_path, f-o{output_dir}, -y]) for root, dirs, files in os.walk(output_dir): for f in files: if f.endswith(.html) or f.endswith(.htm): filepath os.path.join(root, f) with open(filepath, r, encodinggbk, errorsignore) as fh: soup BeautifulSoup(fh.read(), html.parser) text soup.get_text() # 保存为txt或者进一步处理这个脚本的关键点在于编码处理。CHM里的HTML文件编码五花八门有GBK、GB2312、UTF-8甚至还有ISO-8859-1。用errorsignore可以跳过无法解码的字符避免脚本崩溃。如果你对提取质量要求高可以先检测文件的meta charset标签根据它来决定用哪种编码打开。6.2 把CHM内容迁移到现代文档系统现在很多团队用Confluence、Notion或者GitBook来管理文档。如果你想把旧的CHM内容迁移过去直接复制粘贴往往格式全乱。我的做法是先用上面的脚本提取纯文本保留标题层级通过h1到h6标签判断然后生成Markdown文件。Markdown的标题语法和CHM的目录树结构天然对应迁移起来很顺畅。图片的处理稍微麻烦一点。CHM里的图片解压出来之后是散落在各个文件夹里的你需要把它们统一放到一个assets文件夹然后把Markdown里的图片链接改成相对路径。如果图片很多可以写个脚本自动重命名和移动。6.3 制作CHM时的一些个人心得做了这么多年的CHM我最大的体会是内容质量永远比格式重要。我见过太多CHM文件界面花哨、目录复杂但内容空洞、错误百出。反过来有些CHM就是简单的HTML页面目录树也很朴素但内容扎实、条理清晰读起来非常舒服。另外CHM的全文搜索功能是它最大的杀手锏。你在制作时一定要确保每个页面的title标签和h1标签写得准确因为搜索结果的排序和这些标签的权重有关。关键词索引也要认真做把用户可能搜索的同义词、缩写、错误拼写都加进去。比如一个函数叫getUserName索引里除了这个词还要加上get username、获取用户名、用户名获取这些变体。最后CHM虽然是个老格式但它的设计理念——单文件、离线、全文检索——在今天依然有生命力。如果你在做内部知识库或者离线文档不妨考虑用CHM的思路来组织内容哪怕最终输出的是PDF或者静态网站这种“编译后分发”的模式依然高效可靠。 
长河君 · 2026/10/9 20:56:43 · 阅读 1.2k CHM文件全解析：打开、转换与制作实战指南
1. 先搞清楚CHM到底是个什么东西CHM这三个字母全称是Compiled HTML Help翻译过来就是“编译后的HTML帮助文件”。微软在九十年代末推出这个格式本意是给Windows应用程序做离线帮助文档用的。它把一堆HTML页面、图片、CSS样式表、甚至JavaScript脚本全部打包压缩进一个单一文件里再用一个索引系统把它们串起来。你可以把它理解成一本自带目录和搜索功能的电子书只不过这本书的排版语言是网页那一套。我第一次接触CHM大概是十几年前当时下载了一个开发工具的离线文档双击打开之后左边是树形目录右边是内容区域顶部还有搜索框和前进后退按钮。那个体验在当时来说相当惊艳因为整个文件才几兆大小却装了几百页的内容而且不需要联网就能全文检索。后来我才知道CHM内部用的是LZX压缩算法压缩率相当高再加上HTML本身是文本格式所以体积控制得非常好。这个格式最大的优势有三个。第一是单文件便携不管你是拷到U盘里还是通过邮件发给别人一个文件就搞定不会出现“图片丢失”“样式错乱”这种问题。第二是离线可用所有内容都在本地没有网络也能正常浏览和搜索。第三是制作成本低只要你懂一点HTML就能用工具把网页打包成CHM。正因为这些特点CHM在软件文档、技术手册、电子书、教程合集这些场景里被广泛使用。不过CHM也有它的问题。它是微软的专有格式在Windows上原生支持但到了macOS或者Linux上就没那么方便了。而且CHM文件本身可以内嵌脚本这就带来了一些安全隐患所以很多邮件系统会直接拦截CHM附件。另外随着在线文档和PDF的普及CHM的使用频率确实在下降但存量文件依然巨大尤其是在一些传统行业和旧版软件的文档包里你经常能碰到它。提示如果你手头有一个CHM文件但不知道怎么处理先别急着删。它的内容往往比你在网上能找到的版本更完整尤其是那些已经停止维护的软件文档。2. 打开CHM文件的几种靠谱方式2.1 Windows系统下的原生打开方法在Windows上打开CHM是最省事的因为系统本身就内置了支持。你只需要双击文件系统就会调用hh.exe这个程序来渲染内容。这个程序从Windows 98时代就存在了一直保留到现在。打开之后你会看到一个标准的帮助窗口左侧是目录树右侧是内容区顶部有隐藏/显示目录的按钮、前进后退、主页、打印、搜索等常用功能。但这里有一个非常常见的坑很多从网上下载的CHM文件双击之后右侧内容区显示“已取消到该网页的导航”或者一片空白。这不是文件损坏而是Windows的安全机制在作祟。因为CHM文件可能包含恶意脚本所以系统会对来自网络的文件加一个“锁定”标记。解决办法很简单右键点击CHM文件选择“属性”在“常规”选项卡底部你会看到一个“解除锁定”的复选框勾上它再点确定重新打开就能正常显示了。还有一个情况是打开之后左侧目录正常但点击任何条目右侧都提示“无法显示此页”。这通常是因为文件路径里包含了中文或者特殊字符或者文件被放在了网络共享路径下。把CHM文件复制到本地硬盘的一个纯英文路径下比如D:\docs\再打开基本就能解决。2.2 macOS和Linux上的替代方案macOS从很早的版本开始就不再原生支持CHM了。如果你在Mac上双击一个CHM文件系统可能会提示你选择打开方式但找不到合适的程序。这时候你需要借助第三方工具。我试过几个比较推荐的是CHM Reader和Clearview。前者是一个轻量级的阅读器界面简洁支持目录导航和全文搜索后者功能更全一些支持标注和书签但界面稍微老旧一点。安装方式也很简单下载dmg文件拖到Applications文件夹就行。打开之后如果遇到乱码大概率是编码问题。CHM内部的HTML页面可能用的是GBK或者GB2312编码而阅读器默认用UTF-8去解析就会显示成乱码。你可以在阅读器的偏好设置里手动指定编码为GBK试试。Linux上的选择就更少了。有一个叫xCHM的工具可以通过包管理器安装比如在Ubuntu上执行sudo apt install xchm。它的功能比较基础但应付日常阅读足够了。如果你不想装额外软件还有一个办法是用7z命令把CHM解压出来。CHM本质上是一个压缩包7z x filename.chm就能把里面的HTML文件全部提取到一个文件夹里然后用浏览器直接打开index.html或者toc.html。这个方法虽然原始但胜在通用任何系统上只要有7z就能用。2.3 手机端能不能看CHM手机上原生支持CHM的应用非常少。Android平台有一个叫CHM Reader的App界面比较简陋但能用。iOS上就更少了我试过几个都不太理想要么是广告太多要么是打开大文件就崩溃。如果你真的需要在手机上看CHM我的建议是先在电脑上把它转成PDF或者EPUB然后再传到手机上看。转换方法后面会详细讲。注意不管用什么工具打开CHM如果文件来源不明最好先在虚拟机或者沙箱环境里打开确认安全之后再在主力机器上操作。CHM内嵌脚本的能力是一把双刃剑。3. 把CHM转换成其他格式的完整实操3.1 为什么需要转换CHM虽然方便但它的局限性也很明显。首先是跨平台支持差你发给一个用Mac的同事他可能折腾半天也打不开。其次是编辑困难CHM是编译后的格式你想改里面一个错别字不能直接编辑得先反编译再重新编译。再次是打印和批注不方便虽然CHM阅读器一般都有打印功能但排版效果往往不尽如人意。最后是长期保存的考虑CHM是专有格式未来某一天微软彻底放弃支持也不是不可能而PDF和EPUB是开放标准保存年限更长。所以把CHM转换成PDF、EPUB或者纯HTML是一个很实际的需求。下面我分场景来讲具体的操作方法。3.2 转换成PDF的两种实用方案方案一用虚拟打印机。这是最简单的方法不需要安装任何额外软件。在Windows上打开CHM文件然后按CtrlP调出打印对话框在打印机列表里选择Microsoft Print to PDF然后点击打印。系统会让你选择保存路径确认之后就会生成一个PDF文件。这个方法的优点是操作极其简单缺点是它只能打印当前页面不能一次性把整个CHM的所有页面都打印出来。如果你要转换的CHM页面不多比如就十几页那这个方法完全够用。但如果是有几百页的大文件一页一页打印会让人崩溃。方案二先反编译再合并。这个方法稍微复杂一点但可以一次性处理整个CHM。首先用7z把CHM解压到一个文件夹里你会看到一堆.html文件和资源文件夹。然后你需要一个工具把这些HTML按顺序合并成一个PDF。我常用的是wkhtmltopdf这个命令行工具它可以把HTML渲染成PDF而且支持目录和页码。基本用法是wkhtmltopdf --enable-local-file-access toc.html output.pdf其中toc.html是CHM的目录页。不过实际操作中你会发现CHM的HTML文件之间的链接关系比较复杂直接合并可能会丢失导航结构。更稳妥的做法是先用一个脚本把HTML文件按目录顺序整理好生成一个总目录页再用wkhtmltopdf转换。如果你不想碰命令行还有一个图形化工具叫CHM to PDF Converter界面很直观选好输入文件和输出路径点一下转换就行。不过这类工具大多是收费的免费版会有页数限制或者水印。我个人的建议是如果只是偶尔转一两个文件用虚拟打印机就够了如果经常需要处理CHM花点时间学一下wkhtmltopdf的命令行用法会更高效。3.3 转换成EPUB的流程EPUB是电子书的标准格式在手机和平板上阅读体验很好。把CHM转成EPUB核心思路是先把CHM反编译成HTML再把HTML重新打包成EPUB。这里推荐一个工具叫Calibre它是一个功能非常强大的电子书管理软件内置了格式转换功能。具体操作步骤是这样的先用7z把CHM解压到一个文件夹然后在Calibre里点击“添加书籍”选择解压出来的index.html或者toc.html。Calibre会把它识别为一本书然后你点击“转换书籍”在输出格式里选择EPUB再点确定。Calibre会自动处理章节划分、目录生成、图片嵌入这些事情。转换完成之后你可以用Calibre自带的阅读器预览效果如果目录层级不对可以在转换设置里手动调整“目录”选项。这里有一个细节需要注意CHM里的HTML文件可能引用了外部CSS和图片解压之后这些资源的相对路径可能会变。Calibre在转换时一般能自动处理但如果发现样式丢失你需要检查一下HTML文件里的link和img标签的路径是否正确。有时候CHM里的路径用的是反斜杠\而Calibre期望的是正斜杠/手动替换一下就能解决。3.4 直接提取为纯HTML网站如果你想把CHM的内容放到网上或者内网服务器上供多人访问那直接提取为HTML是最合适的。用7z解压之后你会得到一个完整的静态网站结构。但直接打开index.html可能会发现左侧目录树不工作因为CHM的目录树通常是用一个特殊的ActiveX控件或者JavaScript实现的脱离CHM环境之后这些功能会失效。解决办法是找一个替代的目录导航方案。最简单的是用iframe做一个左右分栏的页面左边放一个自己生成的目录列表右边用iframe加载内容页。你可以写一个简单的脚本遍历所有HTML文件提取它们的标题生成一个嵌套的ul列表。这个脚本用Python写也就二三十行的事情。如果你不想写代码也有一些现成的工具比如CHM Decoder它可以在解压的同时生成一个兼容现代浏览器的目录导航。提示提取出来的HTML文件里可能包含一些CHM特有的object标签或者ms-its协议链接这些在普通浏览器里是无法识别的。你可以用文本编辑器的批量替换功能把这些标签清理掉或者替换成普通的a链接。4. 自己动手制作一个CHM文件4.1 制作CHM的准备工作制作CHM其实比很多人想象的要简单。你不需要什么昂贵的软件只需要准备好HTML内容和一个编译工具。HTML内容可以是手写的也可以是用工具从Markdown或者Word转换过来的。关键是要有一个清晰的目录结构因为CHM的导航树就是根据这个结构生成的。你需要准备的东西包括一个文件夹里面放所有的HTML文件、图片、CSS文件一个.hhp项目文件用来告诉编译器哪些文件要打包、首页是哪个、目录结构是怎样的一个.hhc目录文件定义左侧导航树的层级还有一个.hhk索引文件定义关键词索引。这三个文件都是纯文本格式用记事本就能编辑。编译工具方面微软官方提供了一个叫HTML Help Workshop的免费工具虽然界面老旧但功能完整。下载安装之后打开它新建一个项目按照向导一步步操作就行。如果你不想用这个老古董也有一些第三方的命令行工具比如chmcmd它是Free Pascal项目的一部分跨平台支持比较好。4.2 编写HHP项目文件的关键参数.hhp文件是整个项目的核心配置文件它决定了编译出来的CHM长什么样。我拿一个实际用过的配置来举例说明[OPTIONS] Compatibility1.1 or later Compiled filemyhelp.chm Contents filemyhelp.hhc Index filemyhelp.hhk Default topicindex.html Display compile progressYes Full-text searchYes Language0x804 中文(简体) Title我的帮助文档 [FILES] index.html chapter1.html chapter2.html images/logo.png styles/main.css [INFOTYPES]这里有几个参数值得展开讲。Compiled file指定输出的CHM文件名。Default topic是打开CHM时默认显示的页面。Full-text searchYes开启全文搜索功能这个非常实用建议一定要打开。Language指定语言代码0x804代表简体中文设置正确之后搜索和排序才会符合中文习惯。[FILES]段列出所有需要打包的文件注意路径要用相对路径而且分隔符用反斜杠。一个常见的坑是文件路径里包含空格或者中文。虽然CHM规范理论上支持但实际编译时经常出问题。我的经验是所有文件名和路径都用纯英文小写字母加数字不要有空格用下划线或者短横线代替。这样能避免百分之九十的编译错误。4.3 生成目录树和索引.hhc文件定义了左侧的目录树结构。它的格式是HTML的ul和li嵌套但用object标签来指定每个条目的名称和链接。比如!DOCTYPE HTML PUBLIC -//IETF//DTD HTML//EN HTML HEAD meta nameGENERATOR contentMicrosoft HTML Help Workshop /HEAD BODY UL LIOBJECT typetext/sitemap param nameName value第一章 概述 param nameLocal valuechapter1.html /OBJECT UL LIOBJECT typetext/sitemap param nameName value1.1 背景介绍 param nameLocal valuechapter1.html#section1 /OBJECT /UL /UL /BODY /HTML这个结构看起来有点啰嗦但逻辑很清晰。每个OBJECT代表一个目录条目Name是显示的文字Local是链接的目标。嵌套的UL表示子层级。你可以手动写这个文件也可以用工具自动生成。如果HTML文件很多手动写会非常痛苦建议写一个脚本从HTML的h1到h3标签里提取标题和锚点自动生成.hhc文件。.hhk索引文件的格式类似但它是用来做关键词索引的。每个条目包含一个关键词和对应的链接。用户可以在搜索框里输入关键词然后从索引列表里跳转到对应页面。这个功能对于技术文档特别有用因为用户往往想直接查某个函数名或者参数名。4.4 编译与调试配置文件和内容都准备好之后就可以编译了。如果用HTML Help Workshop点击“编译”按钮就行。如果用命令行工具执行hhc myhelp.hhp。编译过程中如果出错工具会给出具体的错误信息比如“文件未找到”“链接无效”之类的。根据提示逐个修复就行。编译成功之后双击生成的CHM文件检查以下几个方面目录树是否正常显示点击每个条目是否能正确跳转全文搜索是否能返回结果图片和样式是否正常加载。如果发现某个页面显示空白大概率是路径问题检查.hhp文件里的[FILES]段是否包含了那个文件。还有一个容易忽略的点是CHM的窗口样式。你可以在.hhp文件的[WINDOWS]段里定义窗口的大小、位置、是否显示导航面板等。比如[WINDOWS] main我的帮助文档,myhelp.hhc,myhelp.hhk,index.html,index.html,,,,,0x23520,,0x384e,,,,,,,,0这一长串参数看起来吓人但常用的就前面几个窗口标题、目录文件、索引文件、默认页面、主页。后面的参数控制按钮显示和窗口样式不设置也能用默认值。注意编译CHM时如果HTML文件里引用了外部网络资源比如CDN上的CSS或者字体编译出来的CHM在离线环境下会加载失败。所有资源都要本地化这是制作CHM的铁律。5. 常见问题与排查技巧实录5.1 打开CHM时提示“导航已取消”或内容空白这是最高频的问题没有之一。根本原因是Windows对来自网络的文件加了安全锁定。解决办法就是右键属性解除锁定。但有时候你解除了锁定换一台电脑又出现同样的问题。这是因为锁定信息是存在文件本身的备用数据流里的拷贝到其他电脑时如果用了不支持备用数据流的文件系统比如FAT32锁定信息可能会丢失但也可能被重新加上。如果你经常需要分发CHM文件可以在编译时就在.hhp文件里加上Binary IndexNo这样编译出来的CHM不会包含索引二进制数据减少被安全软件误判的概率。另外把CHM文件打包成ZIP再分发用户解压之后一般就不会被锁定了。5.2 目录树显示乱码这个问题通常出现在非中文Windows系统上打开中文CHM时。原因是CHM内部的目录树数据用了特定的编码而系统默认的语言设置不匹配。解决办法是在控制面板的“区域和语言选项”里把“非Unicode程序的语言”设置为中文简体。这个设置需要重启才能生效。如果你不想改系统设置也可以用7z把CHM解压出来找到.hhc文件用记事本打开另存为UTF-8编码然后再重新编译成CHM。不过这个方法比较绕适合对CHM结构比较熟悉的人。5.3 全文搜索失效CHM的全文搜索依赖于编译时生成的索引文件。如果编译时没有勾选Full-text search或者索引文件损坏搜索功能就会失效。检查.hhp文件里是否有Full-text searchYes这一行。另外如果CHM文件被部分损坏搜索索引也可能读不出来。这时候只能重新编译或者找原始文件重新下载。还有一个情况是搜索能返回结果但点击结果跳转不到正确页面。这通常是因为HTML文件里的锚点名称和索引里记录的不一致。检查一下.hhk文件里的Local参数是否包含了正确的锚点名称。5.4 制作CHM时编译报错“文件未找到”这个错误的根源几乎总是路径问题。CHM编译器对路径的容忍度很低不支持绝对路径不支持..上级目录引用不支持中文路径不支持空格。所有文件必须放在.hhp文件所在目录或者其子目录下路径用反斜杠分隔文件名用纯英文。我踩过的一个坑是在.hhp的[FILES]段里写了images\logo.png但实际文件夹名字是Images大小写不一致。Windows文件系统不区分大小写但CHM编译器区分。改成完全一致之后问题解决。所以建议所有文件夹和文件名统一用小写避免这种低级错误。5.5 CHM文件太大导致打开缓慢CHM的LZX压缩率很高但解压需要时间。如果一个CHM文件超过50MB打开时可能会有明显的卡顿。优化方法有几个一是压缩图片把BMP转成JPG或者PNG把PNG用工具再压缩一遍二是合并CSS和JavaScript文件减少HTTP请求数虽然CHM是本地文件但每个外部文件都要单独解压三是拆分CHM把一个大文件拆成几个小文件比如按章节拆分。还有一个技巧是在.hhp文件里设置CompressYes这是默认开启的。如果你发现编译出来的CHM比预期大很多检查一下是不是有些没用的文件也被打包进去了。[FILES]段里只列出真正需要的文件不要用通配符把整个文件夹都包进去。5.6 快速排查表问题现象最可能原因解决方法打开后内容区空白文件被锁定右键属性解除锁定目录树乱码系统语言不匹配修改非Unicode程序语言设置搜索无结果未开启全文搜索重新编译并勾选Full-text search编译报错文件未找到路径大小写或分隔符错误统一小写用反斜杠图片不显示资源未打包或路径错误检查[FILES]段是否包含图片打开速度慢文件过大压缩图片拆分文件跳转链接失效锚点名称不匹配检查hhc/hhk文件中的Local参数提示遇到任何CHM相关的问题第一步永远是用7z把它解压出来看看内部结构。大部分问题在解压之后都能一目了然。6. 一些进阶玩法和个人经验6.1 用脚本批量处理CHM文件如果你手头有几十个CHM文件需要转换或者提取内容一个个手动操作太慢了。我写过一个Python脚本用subprocess调用7z批量解压然后用BeautifulSoup解析HTML提取正文最后输出成Markdown或者纯文本。核心代码大概是这样import subprocess import os from bs4 import BeautifulSoup def extract_chm(chm_path, output_dir): subprocess.run([7z, x, chm_path, f-o{output_dir}, -y]) for root, dirs, files in os.walk(output_dir): for f in files: if f.endswith(.html) or f.endswith(.htm): filepath os.path.join(root, f) with open(filepath, r, encodinggbk, errorsignore) as fh: soup BeautifulSoup(fh.read(), html.parser) text soup.get_text() # 保存为txt或者进一步处理这个脚本的关键点在于编码处理。CHM里的HTML文件编码五花八门有GBK、GB2312、UTF-8甚至还有ISO-8859-1。用errorsignore可以跳过无法解码的字符避免脚本崩溃。如果你对提取质量要求高可以先检测文件的meta charset标签根据它来决定用哪种编码打开。6.2 把CHM内容迁移到现代文档系统现在很多团队用Confluence、Notion或者GitBook来管理文档。如果你想把旧的CHM内容迁移过去直接复制粘贴往往格式全乱。我的做法是先用上面的脚本提取纯文本保留标题层级通过h1到h6标签判断然后生成Markdown文件。Markdown的标题语法和CHM的目录树结构天然对应迁移起来很顺畅。图片的处理稍微麻烦一点。CHM里的图片解压出来之后是散落在各个文件夹里的你需要把它们统一放到一个assets文件夹然后把Markdown里的图片链接改成相对路径。如果图片很多可以写个脚本自动重命名和移动。6.3 制作CHM时的一些个人心得做了这么多年的CHM我最大的体会是内容质量永远比格式重要。我见过太多CHM文件界面花哨、目录复杂但内容空洞、错误百出。反过来有些CHM就是简单的HTML页面目录树也很朴素但内容扎实、条理清晰读起来非常舒服。另外CHM的全文搜索功能是它最大的杀手锏。你在制作时一定要确保每个页面的title标签和h1标签写得准确因为搜索结果的排序和这些标签的权重有关。关键词索引也要认真做把用户可能搜索的同义词、缩写、错误拼写都加进去。比如一个函数叫getUserName索引里除了这个词还要加上get username、获取用户名、用户名获取这些变体。最后CHM虽然是个老格式但它的设计理念——单文件、离线、全文检索——在今天依然有生命力。如果你在做内部知识库或者离线文档不妨考虑用CHM的思路来组织内容哪怕最终输出的是PDF或者静态网站这种“编译后分发”的模式依然高效可靠。