简介HTML Help Workshop 汉化版面向需要制作 CHM 帮助文档的中文用户尤其是软件开发者、技术写手与文档维护人员。原版为微软官方英文工具汉化后提供全中文界面降低了国内用户学习与操作门槛可用于编写 HTML 页面、创建关键词索引、组织项目资源、预览效果并最终编译成体积小、加载快且支持搜索的 CHM 文件。资源包共 4 个文件以 txt 说明文档、html 页面和 exe 安装程序为主压缩包约 3.34MB其中汉化说明与汉化新世纪文本记录了汉化过程及使用注意事项html 文件保留了发布页面的版本与下载信息exe 为可安装的汉化主程序。目前已有 941 人学习下载适合希望快速上手 CHM 制作、了解汉化版安装与使用细节的读者参考。1. 从一次 CHM 编译翻车说起为什么我还在用 HTML Help Workshop 汉化版上个月帮一个做内部工具文档的朋友处理一个老项目的帮助文件他扔过来一个.hhp工程说用新版工具打开就报错编译出来的 CHM 目录树全是乱码。我第一反应是编码问题折腾了半天才发现他用的那个所谓“新版”其实是个套壳编辑器底层调的还是老引擎对中文路径和 GBK 编码的支持一塌糊涂。最后换回 HTML Help Workshop 汉化版十分钟搞定。这事让我意识到有些工具虽然年纪大但在特定场景下依然是刚需——尤其是你要编译纯中文的 CHM 帮助文档时原版英文界面加上对中文字符集的微妙处理很容易让人在配置环节就卡住。HTML Help Workshop 汉化版就是针对这个痛点来的界面菜单、对话框、报错信息全部中文化工程文件里的语言设置、字体映射、目录层级这些参数对着中文提示改比对着英文猜要踏实得多。这篇文章适合两类人一是手头有老项目需要维护 CHM 文档的开发者二是刚接触帮助文件制作、被英文界面劝退的新手。我会把环境要求、安装步骤、工程配置、编译验证和常见报错处理按顺序拆开你照着走一遍至少能少踩我当年踩过的坑。2. 装前环境核对版本、系统组件与依赖清单2.1 版本选择与系统兼容性对照HTML Help Workshop 汉化版并不是一个独立的新软件它是在微软原版 HTML Help Workshop 4.74 基础上做的界面汉化。原版 4.74 是最后一个支持完整 CHM 编译功能的版本后续微软把重心转向了别的文档格式这个工具就停更了。所以你能找到的汉化版底层版本号基本都是 4.74。这里有个版本坑网上有些标着“5.0”或者“2023 重制版”的包其实是把原版安装文件重新打包或者只汉化了主程序没汉化编译器hhc.exe装完你会发现菜单是中文的但编译报错还是英文甚至因为打包者替换了不匹配的itcc.dll导致编译直接崩溃。我一般只认文件版本里明确写着 4.74 的汉化包安装前右键看属性确认hhw.exe和hhc.exe的版本号一致。系统兼容性方面这个工具原生是 32 位程序在 Windows 7、Windows 10、Windows 11 上都能跑但 Windows 10 之后的系统默认开启的“受控文件夹访问”或者杀毒软件的启发式扫描可能会拦截hhc.exe生成 CHM 的动作因为 CHM 编译过程涉及文件压缩和写入。常见做法是安装前把工具目录加入杀毒软件白名单或者临时关闭实时防护。另外如果你在 64 位系统上装安装程序会默认释放到C:\Program Files (x86)\HTML Help Workshop这个路径没问题但后续在工程里引用图片或 CSS 时尽量用相对路径别用带空格的绝对路径否则编译器解析路径时容易出玄学错误。项目要求说明操作系统Windows 7 / 10 / 1132 或 64 位不支持 macOS 和 Linux 原生运行底层版本HTML Help Workshop 4.74汉化版基于此版本版本号不一致的包慎用必要组件Internet Explorer 核心组件CHM 查看器依赖Win10/11 仍保留磁盘空间约 15 MB安装后占用很小权限管理员权限安装和注册组件需要2.2 安装前必须检查的三个系统组件第一个是hh.exe这是 CHM 查看器系统自带但有些精简版系统会把它删掉。检查方法很简单按 WinR 输入hh回车如果能弹出“HTML Help 查看器”窗口就正常报错找不到文件就得先补这个组件。第二个是itcc.dll这是 HTML Help 的编译器核心库原版安装程序会自动注册它但如果你之前装过其他版本的 Workshop 或者手动删过系统目录里的 DLL可能会残留旧版本导致冲突。我一般会在安装前用regsvr32 /u itcc.dll先反注册一下如果提示找不到模块就跳过装完汉化版后再确认C:\Windows\System32下的itcc.dll日期是新的。第三个是hha.dll负责弹出帮助窗口的控件一般不会出问题但如果你的工程里用了HH_ALINK_LOOKUP或者HH_GET_WIN_TYPE这类高级调用这个 DLL 的版本会影响编译结果。提示如果你之前装过英文原版建议先通过控制面板卸载并手动删除安装目录残留的hhw.exe、hhc.exe和hhp文件避免汉化版覆盖安装时文件版本混乱。2.3 汉化包完整性校验与解压注意事项下载下来的汉化包通常是一个压缩文件里面包含setup.exe、hhw.exe、hhc.exe、itcc.dll以及一个汉化说明.txt。解压时注意两点一是不要用 Windows 自带的解压工具直接双击运行先解压到英文路径的文件夹比如D:\HHW_CN路径里不要有中文和空格否则安装程序释放临时文件时可能报“找不到路径”。二是解压后核对文件数量一个完整的汉化包至少应该有 8 到 10 个文件如果只有三四个那可能是只替换了主程序的精简版编译功能大概率不全。我习惯在解压后先对hhc.exe右键看属性确认“文件版本”是 4.74.8702.0这个版本号是原版 4.74 的典型编译版本汉化版不会改这个数字如果显示的是其他版本说明底层被换过编译出来的 CHM 可能在旧系统上打不开。3. 安装与初始配置从释放文件到中文界面生效3.1 执行安装程序与路径选择解压完成后右键setup.exe选择“以管理员身份运行”。安装向导第一步是欢迎界面汉化版这里已经显示中文直接点“下一步”。第二步是许可协议勾选“接受协议”继续。第三步是选择安装路径默认是C:\Program Files (x86)\HTML Help Workshop我建议保持默认因为后续很多教程和脚本引用的都是这个路径改了反而容易在注册表关联上出问题。如果你 C 盘空间紧张可以改到 D 盘但路径里不要出现中文比如D:\HTMLHelpCN可以D:\帮助文档工具就不行。第四步是选择安装类型选“典型安装”即可它会同时安装主程序、编译器、查看器和示例工程。第五步是开始菜单文件夹默认“HTML Help Workshop”就行点“安装”按钮进度条走完大概十几秒。安装完成后安装程序会弹出一个“是否立即注册组件”的对话框这里一定要选“是”它会自动调用regsvr32注册itcc.dll和hha.dll。如果这一步你点了“否”后面编译 CHM 时会报“编译器未正确初始化”的错误到时候还得手动补注册比较麻烦。注册成功后桌面和开始菜单会出现“HTML Help Workshop 汉化版”的快捷方式先别急着打开我们还要做一步兼容性设置。3.2 兼容性设置与管理员权限固化在 Windows 10 和 11 上这个老程序直接双击打开可能会因为 UAC 弹窗导致界面卡住或者编译时因为权限不足无法写入输出目录。我一般会右键快捷方式 → 属性 → 兼容性勾选“以管理员身份运行此程序”同时点击“更改高 DPI 设置”勾选“替代高 DPI 缩放行为”缩放执行选“系统增强”。这样做的原因是汉化版的对话框控件是基于旧版 MFC 写的在高分屏上如果不做 DPI 替代按钮和文字会挤在一起看不清“编译”和“取消”的区别。另外如果你用的是 4K 显示器建议把系统缩放调到 150% 以下否则工程属性页里的输入框会变得特别小。注意勾选“以管理员身份运行”后每次打开都会弹 UAC 确认框这是正常的。如果你觉得烦可以用任务计划程序创建一个以最高权限运行的任务但普通使用场景下没必要折腾。3.3 首次启动后的中文界面验证与语言设置双击桌面图标启动如果界面菜单显示的是“文件”“编辑”“视图”“项目”“编译”“窗口”“帮助”说明汉化生效了。如果还是英文检查安装目录下是否有hhw.exe和hhw.chm两个文件汉化版通常会把英文语言资源替换掉如果只替换了主程序没替换资源文件菜单可能还是英文。这时候可以手动把汉化包里的hhw.exe复制到安装目录覆盖再重启程序。启动后第一件事是设置默认语言。点击菜单“项目” → “属性”在弹出的对话框里找到“语言”选项卡选择“中文简体中国”字符集选“GB2312”。这一步很关键它决定了编译器生成 CHM 时索引和目录的编码方式。如果你选了“UTF-8”编译出来的 CHM 在部分旧版 Windows 上打开会乱码因为 CHM 查看器默认按系统区域设置解析编码。我一般还会在“编译器”选项卡里把“输出文件”的扩展名确认为.chm并勾选“编译时显示进度信息”这样编译过程中能看到每一步在做什么出错了也好定位。4. 工程配置与编译参数让 CHM 正确输出中文4.1 新建工程与导入现有 .hhp 文件点击“文件” → “新建”选择“项目”向导会问你是要新建一个工程还是导入现有的.hhp文件。如果你手头已经有.hhp直接选“导入”然后浏览到文件位置。导入时注意如果原工程是用英文版创建的里面的Language字段可能是0x409英文导入后要在“项目属性”里改成0x804简体中文否则编译出来的目录树标题会显示成英文的“Contents”而不是“目录”。新建工程的话向导会让你指定工程文件名和存储路径同样建议用英文路径比如D:\Projects\HelpDoc工程名用MyHelp.hhp。新建完成后主界面左侧会出现“项目”选项卡里面列出了[OPTIONS]、[FILES]、[ALIAS]、[MAP]等节。[OPTIONS]里最重要的是Compiled file和Contents file两个字段。Compiled file指定输出的 CHM 文件名比如MyHelp.chmContents file指定目录文件通常是.hhc文件。如果你没有现成的.hhc可以点“目录”选项卡手动创建或者用工具从 HTML 文件自动生成。4.2 配置 [OPTIONS] 节的关键参数在“项目”选项卡里双击[OPTIONS]或者右键选“属性”会打开一个参数列表。这里我列几个必须改的[OPTIONS] Binary TOCYes Binary IndexYes Compiled fileMyHelp.chm Contents fileMyHelp.hhc Index fileMyHelp.hhk Default topicindex.html Display compile progressYes Full-text searchYes Language0x804 Chinese (Simplified, China) Title我的帮助文档逐条说明Binary TOCYes和Binary IndexYes让目录和索引以二进制形式编译加载速度更快但如果你后续要手动编辑.hhc文件建议先设为No等调试完再改回来。Compiled file是输出文件名不要带路径编译器会把它放在工程文件同目录。Default topic是打开 CHM 时默认显示的页面必须是一个已经在[FILES]里列出的 HTML 文件。Language0x804是简体中文的语言代码这个值直接决定 CHM 内部字符串的编码写错了就会乱码。Title是 CHM 窗口标题栏显示的文字支持中文。提示如果你在[OPTIONS]里改了Language但编译后目录还是乱码检查一下.hhc文件本身的编码。用记事本打开.hhc另存为时选择“ANSI”编码不要选“UTF-8”。因为hhc.exe编译器默认按 ANSI 读取.hhc文件UTF-8 带 BOM 的话会在文件头插入不可见字符导致目录树解析失败。4.3 添加 HTML 文件与目录层级设置在“项目”选项卡里点击[FILES]然后点“添加”按钮把你要打包的 HTML 文件、CSS、图片全部加进来。注意图片和 CSS 不需要手动加到[FILES]里编译器会自动根据 HTML 里的引用关系打包但前提是引用路径必须是相对路径。如果你用了backgroundC:\images\bg.jpg这种绝对路径编译出来的 CHM 在别人电脑上打开就会缺图。我一般会在工程根目录下建一个images文件夹HTML 里写srcimages/logo.png这样最稳妥。目录层级在“目录”选项卡里设置。点击“插入标题”可以添加一级目录选中标题后点“插入页面”可以添加子页面。每个页面需要指定“名称”显示在目录树里的文字和“文件”对应的 HTML 文件。如果你有几十个页面手动加很累可以用“自动生成目录”功能但自动生成的层级通常很平需要手动调整。调整时注意目录树的缩进层级不要超过三级太深了在 CHM 窗口里显示不全用户得横向滚动才能看到体验很差。4.4 编译输出与错误日志解读配置完成后点击工具栏上的“编译”按钮图标是一个小锤子或者按 F5。编译过程中底部会显示进度信息如果一切正常最后一行会显示“编译完成0 个错误0 个警告”。如果报错常见的有这几类HHC5003: Error: While compiling...后面跟着文件名通常是 HTML 文件里有未闭合的标签或者引用了不存在的图片。解决办法是用浏览器打开那个 HTML 确认显示正常再检查图片路径。HHC5010: Error: Cannot open...一般是.hhc或.hhk文件被其他程序占用或者路径里有中文。关掉可能占用文件的编辑器把工程移到纯英文路径下重试。HHC3004: Warning: The file...警告通常不影响编译但最好处理掉比如某个 HTML 文件没有被任何目录引用编译器会提示“文件未包含在目录中”你可以选择忽略或者把它加到目录里。编译成功后在工程目录下会生成.chm文件双击就能打开查看效果。如果打开后目录树是空的检查[OPTIONS]里的Contents file是否指向了正确的.hhc文件以及该文件是否真的存在。5. 避坑与排查汉化版安装配置中最容易翻车的五件事5.1 编译报错“itcc.dll 未注册”或“编译器初始化失败”现象点击编译后底部直接红字报错提示Cannot load itcc.dll或者Compiler not initialized。原因通常是安装时没有勾选“注册组件”或者系统里存在多个版本的itcc.dll导致注册表指向了错误路径。解决方法是手动注册以管理员身份打开命令提示符输入regsvr32 C:\Program Files (x86)\HTML Help Workshop\itcc.dll回车后如果弹出“DllRegisterServer 成功”就说明注册好了。如果还不行检查C:\Windows\System32下是否有一个旧的itcc.dll有的话先重命名为itcc.dll.bak再重新注册安装目录下的那个。5.2 中文目录或文件名导致编译中断现象编译到一半突然停止日志里显示某个文件“找不到”或“无法打开”但文件明明存在。原因就是路径里带了中文比如D:\我的文档\帮助工程\index.html。hhc.exe是 32 位程序对 Unicode 路径的支持不完整遇到中文路径时可能解析失败。解决办法很简单把整个工程移到纯英文路径下比如D:\Work\HelpProject所有文件名也改成英文。如果 HTML 内容里必须显示中文那没问题只是文件名和路径不要用中文。5.3 编译出的 CHM 打开后目录乱码或显示问号现象CHM 能打开但左侧目录树里的文字全是乱码或者问号。原因有两个一是[OPTIONS]里的Language没设成0x804二是.hhc文件保存成了 UTF-8 编码。解决方法是先确认Language0x804 Chinese (Simplified, China)然后用记事本打开.hhc文件另存为时编码选“ANSI”保存后重新编译。如果还是乱码检查系统区域设置里“非 Unicode 程序的语言”是否设成了“中文简体中国”有些英文系统默认是“英语美国”会导致 CHM 查看器按错误编码解析。5.4 杀毒软件误删 hhc.exe 或拦截编译进程现象安装完汉化版后双击图标没反应或者编译到一半杀毒软件弹窗说“发现威胁”。原因是hhc.exe的行为特征压缩文件、写入可执行内容容易被启发式引擎误判。解决办法是把安装目录加入杀毒软件的白名单或者临时关闭实时防护再编译。如果hhc.exe已经被删了从汉化包里重新复制一份过去再恢复白名单。我一般会在装完后先手动扫描一次安装目录确认没有误报再开始用。5.5 高 DPI 屏幕下界面错位导致按钮点不到现象在 4K 显示器上打开对话框里的“确定”“取消”按钮重叠在一起或者工程属性页的输入框只显示一半。原因是程序没有声明 DPI 感知系统强制缩放后控件位置计算错误。解决办法是右键快捷方式 → 属性 → 兼容性 → 更改高 DPI 设置 → 勾选“替代高 DPI 缩放行为”缩放执行选“系统增强”。如果还是错位把系统缩放临时调到 100%配置完工程再调回去。这个坑在笔记本外接 4K 显示器时特别常见我至少遇到过三次。6. 装完怎么验证跑通从编译到跨机打开的完整检查装完配置好别急着关掉工程。我一般会走一遍完整的验证流程确保这个 CHM 拿到别的电脑上也能正常打开。第一步在工程目录下找到生成的.chm文件双击打开看左侧目录树是否正常显示中文点击几个页面看内容是否完整图片是否加载。第二步按 CtrlF 打开搜索面板输入一个中文关键词看全文搜索是否能命中。这一步能验证Full-text searchYes是否生效以及索引文件.hhk是否编译正确。第三步把.chm文件复制到一个没有安装 HTML Help Workshop 的电脑上或者虚拟机里双击打开。如果提示“无法打开文件”或者“导航到网页已取消”说明 CHM 里引用了外部绝对路径的资源或者Default topic设置了一个不存在的文件。第四步在另一台电脑上检查 CHM 属性里的“语言”是否显示为中文如果显示英文说明Language参数没生效需要回到工程属性里重新确认。这里有个小技巧编译完成后用hh.exe -decompile命令把 CHM 反编译回 HTML 文件对比一下源文件和反编译出来的文件是否一致。命令是hh.exe -decompile D:\output D:\Projects\HelpDoc\MyHelp.chm-decompile后面跟两个参数第一个是输出目录第二个是 CHM 文件路径。反编译后打开输出目录看看图片和 CSS 是否都在HTML 内容有没有被截断。如果反编译出来的文件比源文件少说明编译时有些文件没被打包进去通常是[FILES]里漏加了或者 HTML 里的引用路径写错了。这个检查方法我用了很多年比单纯双击打开 CHM 要可靠得多因为有些资源缺失在 CHM 查看器里不会立刻报错但用户点到那个页面就会看到空白。最后一步把 CHM 文件放到一个带空格和中文的路径下比如D:\测试 文档\MyHelp.chm再双击打开。如果正常说明 CHM 内部没有硬编码路径依赖可以放心分发了。如果打不开检查编译时Compiled file是否用了绝对路径改回相对路径重新编译。从那以后我每次编译完 CHM都会强制走一遍“反编译对比 跨机打开 中文路径测试”这三步宁可多花五分钟也不想让用户打开文档时看到一片空白。希望帮到你。本文还有配套的精品资源点击获取
