企业官网建设流程全解析

简介：HTML Help Workshop 汉化版面向需要制作 CHM 帮助文档的中文用户，包括软件开发者、技术写手及普通使用者，主要解决原版英文界面带来的语言障碍，让国内用户能更顺畅地创建和编辑 Windows 平台下可搜索、可压缩的 CHM 帮助文件。压缩包共 4 个文件，以 txt 说明文档、html 页面和 exe 安装程序为主，整体约 3.34MB，其中汉化说明与汉化新世纪文本记录了汉化过程与使用注意事项，html 文件保留了发布页面的版本与下载信息，exe 为可安装的汉化主程序。该工具内置 HTML 编辑器、索引工具、项目管理器、编译器与预览器，可完成从新建项目、添加资源、编辑内容、构建关键词索引到设置属性、预览效果并最终编译打包的完整流程。目前已有 941 人学习下载，适合希望低成本上手 CHM 制作、快速产出专业级帮助文档的读者参考使用。

1. HTML Help WorkShop 汉化版安装环境清单：先别急着双击 setup

很多人第一次装 HTML Help WorkShop 汉化版，都是拿到压缩包就找 setup.exe，结果装完打开一看，菜单还是英文，编译 CHM 时还弹“找不到 hhc.exe”。这工具本身不复杂，坑全在版本和系统组件上。它是一套用来把 HTML 文件编译成 CHM 帮助文档的老牌工具链，核心是 hhc.exe 和 hha.dll 这一组程序，汉化版通常是在原版基础上替换了资源文件。适合需要给桌面软件做离线帮助文档、又不想上重型文档平台的开发者。装之前先把环境列清楚：系统版本、是否已有旧版、有没有装 HTML Help 运行时，这三样没确认，后面全是玄学问题。

2. 装前准备：确认系统版本与旧版残留

2.1 系统兼容性对照

HTML Help WorkShop 原版年代久远，汉化版一般基于 1.3 或 1.4 版本修改。不同 Windows 版本上的表现差异很大，我一般先按这张表对一遍：

提示：如果你只是要编译 CHM，不一定要装完整 WorkShop，但汉化版通常把编辑器和编译器打包在一起，装完整版更省事。

2.2 清理旧版残留

如果之前装过英文版或其他汉化版，先卸干净。控制面板卸载后，还要手动删两个目录，否则新装上去菜单可能还是旧的：

# 以管理员身份打开 CMD，删除残留目录 rmdir /s /q "C:\Program Files (x86)\HTML Help Workshop" rmdir /s /q "C:\Program Files\HTML Help Workshop" # 清理注册表中残留的 hhc 关联（谨慎操作，先导出备份） reg export "HKEY_CLASSES_ROOT\hhc" hhc_backup.reg reg delete "HKEY_CLASSES_ROOT\hhc" /f

第一段命令删的是安装目录，汉化版有时会装到 Program Files 而不是 Program Files (x86)，两个都清一遍。第二段是导出并删除注册表里 hhc 的关联项，导出那步是后悔药，万一删错了可以双击 reg 文件恢复。我一般还会顺手把C:\Windows\hh.exe留着，那是系统自带的 CHM 阅读器，删了会影响其他软件看帮助文档。

2.3 安装 HTML Help 运行时

Windows 10 之后系统默认不带完整的 HTML Help 运行时，编译时可能报“hha.dll 未找到”。常见做法是装一个HtmlHelp.exe运行时包，或者从已装好的机器上拷贝hha.dll到C:\Windows\System32再注册：

# 拷贝 dll 后注册（假设 dll 放在当前目录） copy hha.dll C:\Windows\System32\ regsvr32 C:\Windows\System32\hha.dll

regsvr32执行成功会弹一个确认框。如果报“模块加载失败”，多半是 dll 位数不对——32 位系统用 32 位 dll，64 位系统如果装的是 32 位 WorkShop，也要用 32 位 dll 放到SysWOW64里注册。

3. 安装汉化版：路径、组件与首次启动

3.1 安装路径选择

汉化版的安装程序一般是setup.exe或install.bat。双击前先右键“以管理员身份运行”，否则写注册表和 Program Files 会失败。安装路径我建议保持默认，不要带中文和空格：

# 推荐路径 C:\HTMLHelpWorkshop\ # 不推荐 D:\我的工具\HTML Help 汉化版\

原因很直接：hhc.exe 在编译时会把项目路径拼进命令行，路径里有空格或中文，某些老版本会解析出错，报“无法打开 .hhp 文件”。如果你非要装到 D 盘，用纯英文短路径，比如D:\HHW\。

3.2 组件勾选说明

安装过程中一般会看到几个勾选项，汉化版可能翻译得不太准，我按原版对应关系列一下：

• HTML Help Workshop：主程序，必选。
• HTML Help Image Editor：截图和简单图像处理，做 CHM 配图时有用，建议选。
• HTML Help Runtime：运行时组件，如果前面没单独装，这里勾上。
• Sample Projects：示例项目，新手可以留着，熟手可以去掉。

注意：如果安装程序里有一个“Register as default CHM editor”之类的选项，先不要勾。等确认编译能跑通再设默认，否则双击 .hhp 文件可能直接报错，连编辑器都打不开。

3.3 首次启动与界面确认

装完从开始菜单启动，第一次打开可能会闪一下然后消失。常见原因是缺少 VB 运行库或权限不足。我一般这样做：

# 以管理员身份运行一次，让程序完成初始化写配置 cd C:\HTMLHelpWorkshop hhw.exe

如果还是闪退，去事件查看器看应用程序日志，多半能看到“模块 msvbvm50.dll 加载失败”之类的记录。补一个 VB6 运行库通常能解决。启动成功后，检查菜单是不是中文——如果还是英文，说明汉化资源没覆盖成功，重新把汉化包里的hhw.exe和hhc.exe覆盖到安装目录。

4. 配置与编译：让 hhc.exe 正常干活

4.1 配置项目文件 .hhp

WorkShop 的核心是 .hhp 项目文件，它决定了编译哪些 HTML、生成什么目录和索引。汉化版新建项目时向导可能翻译得比较生硬，我一般直接手写一个最小 .hhp 再让工具打开：

[OPTIONS] Compatibility=1.1 or later Compiled file=output.chm Contents file=toc.hhc Index file=index.hhk Default topic=index.html Display compile progress=Yes Full-text search=Yes Language=0x804 中文(简体) [FILES] index.html intro.html [INFOTYPES]

Compiled file是输出的 CHM 文件名，Contents file和Index file是目录和索引文件，Language=0x804指定简体中文，不写这行生成的 CHM 搜索可能乱码。[FILES]下面列出所有要打包的 HTML，少写一个就少一个页面。

4.2 命令行编译与参数

图形界面编译偶尔会卡住，我习惯用命令行，方便排查：

# 在项目目录下执行 "C:\HTMLHelpWorkshop\hhc.exe" project.hhp # 输出示例 Microsoft HTML Help Compiler 4.74.8702 Compiling project.hhp Compile time: 0 hours, 0 minutes, 1 second Created output.chm, 12,345 bytes

如果报“HHC5003: Error: Compilation failed”，先看它有没有提示具体哪个文件。常见的是某个 HTML 里引用了不存在的图片，或者 toc.hhc 里写的路径和实际文件对不上。hhc.exe的退出码非 0 就是失败，写脚本时可以用%ERRORLEVEL%判断。

4.3 目录与索引文件写法

toc.hhc 和 index.hhk 是 HTML 格式的，但结构固定，手写容易漏标签：

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN"> <HTML> <BODY> <OBJECT type="text/site properties"> <param name="Window Styles" value="0x800025"> </OBJECT> <UL> <LI><OBJECT type="text/sitemap"> <param name="Name" value="首页"> <param name="Local" value="index.html"> </OBJECT> <LI><OBJECT type="text/sitemap"> <param name="Name" value="简介"> <param name="Local" value="intro.html"> </OBJECT> </UL> </BODY> </HTML>

Name是显示在目录里的文字，Local是对应的 HTML 文件。缩进和换行不影响解析，但<UL>和<LI>必须配对，少一个闭合标签编译时可能不报错但目录显示不全。

5. 避坑与排查：装完打不开、编译报错怎么办

5.1 现象：双击 hhw.exe 没反应或闪退

原因：权限不足、VB 运行库缺失、或之前装过其他版本导致注册表冲突。解决：以管理员运行；装 VB6 运行库；按 2.2 清理注册表后重装。

5.2 现象：编译时提示“Cannot open file hhc.exe”

原因：杀毒软件误删或隔离了 hhc.exe，老工具经常被当成风险程序。解决：去杀毒软件隔离区恢复，并把安装目录加入白名单。我一般装完先手动运行一次 hhc.exe，确认没被拦。

5.3 现象：生成的 CHM 打开后目录空白

原因：toc.hhc 里的Local路径大小写和实际文件名不一致，或者文件没列在 .hhp 的[FILES]里。解决：用dir /b列出实际文件名，逐个核对；确保所有页面都在[FILES]中。

5.4 现象：CHM 里搜索中文没结果

原因：.hhp 里没写Language=0x804，或者编译时系统区域设置不是中文。解决：补上 Language 行重新编译；控制面板里把“非 Unicode 程序的语言”设为中文（简体）。

5.5 现象：汉化版菜单部分英文部分中文

原因：汉化包只替换了主程序，没替换 hhc.exe 或 dll 资源。解决：把汉化包里的所有 exe 和 dll 按目录结构覆盖到安装目录，不要只覆盖 hhw.exe。

6. 验证安装：用最小项目跑通一次编译

装完别急着做正式文档，先拿一个最小项目验证整条链路。我一般建一个临时目录，放三个文件：test.hhp、index.html、toc.hhc。index.html 就写一行字：

<html><body><h1>编译测试</h1><p>如果你看到这行字，说明环境没问题。</p></body></html>

test.hhp 用 4.1 里的模板，把Compiled file改成test.chm，[FILES]只写index.html。toc.hhc 用 4.3 的模板，只留一个Local指向index.html。然后在命令行执行：

"C:\HTMLHelpWorkshop\hhc.exe" test.hhp

看到Created test.chm就成功了一半。双击 test.chm，确认三件事：窗口标题是不是中文、目录里有没有“首页”、搜索“编译”能不能命中。这三样都过，说明汉化、编译、运行时都正常。如果搜索没结果，回到 5.4 检查 Language 设置。

我自己的习惯是每换一台机器或重装系统，都先跑一遍这个最小项目，确认没问题再动正式文档。有一次偷懒跳过这步，结果正式项目编译到一半报错，回头查了半天才发现是 hha.dll 没注册。从那以后我每次装完 HTML Help WorkShop 汉化版，都强制走一遍最小编译验证，不省这一步。希望帮到你。

本文还有配套的精品资源，点击获取