如何在Docker容器中编译HTML Help Workshop项目？解决HHC5010报错

我之前也碰到过类似的容器内编译CHM的问题，Server Core镜像因为精简了很多桌面组件，确实会给HTML Help Workshop（HHW）的运行带来不少限制。结合你的情况，给你几个可行的排查和解决方向：

1. 先排查路径与权限问题 #

HHC5010报错最常见的原因是输出路径没有写入权限或者路径不存在。Server Core容器对C盘根目录的写入权限可能有限制，建议你：

• 先手动创建一个子目录（比如C:\temp），修改项目配置的输出路径：

  [OPTIONS]
  Compiled file=C:\temp\test.chm
  [FILES]
  

• 执行编译命令前确保目录存在，用绝对路径调用工具和项目文件：

  New-Item -Path C:\temp -ItemType Directory -Force
  & 'C:\Program Files (x86)\HTML Help Workshop\hhc.exe' C:\your-project-path\test.hhp
  

2. 补全HHW的完整依赖组件 #

Visual Studio Build Tools安装的HHW是精简版，缺少一些桌面环境下的必要文件。你可以从本地Windows桌面系统的完整HHW安装目录复制文件到容器：

• 复制本地C:\Program Files (x86)\HTML Help Workshop下的所有文件，覆盖容器内同路径的文件
• 复制本地C:\Windows\SysWOW64\hhctrl.ocx到容器的C:\Windows\SysWOW64目录，然后注册这个控件：

  regsvr32 C:\Windows\SysWOW64\hhctrl.ocx
  

这个OCX控件是HHW编译CHM的核心依赖，Server Core镜像默认没有注册这个组件。

3. 切换到带桌面环境的Windows容器镜像 #

如果Server Core的限制实在难以绕过，可以尝试使用完整版的Windows容器镜像（比如mcr.microsoft.com/windows:1809），这个镜像包含了完整的桌面系统组件，HHW的运行环境和本地桌面系统一致，编译成功率更高：

• 拉取镜像：docker pull mcr.microsoft.com/windows:1809
• 启动容器时挂载你的项目目录，安装Visual Studio Build Tools和完整的HHW，再执行编译命令

4. 完善测试项目的配置 #

你的测试项目[FILES]段是空的，虽然理论上可以生成空CHM，但HHW偶尔会因为没有源文件触发异常。建议你添加一个简单的HTML文件测试：

[OPTIONS]
Compiled file=C:\temp\test.chm
[FILES]
C:\temp\test.html

先创建一个空的test.html文件，再执行编译，排除项目配置本身的问题

内容的提问来源于stack exchange，提问作者MakotoE