如何在Microsoft Help Workshop的HTML帮助页中实现类C/C++ #define的常量替换？

嘿，这个需求我太熟悉了！纯静态HTML本身确实没有内置的常量定义功能，但针对Microsoft Help Workshop的CHM制作场景，我们有几个实用的办法来实现批量管理产品名称，不用再一个个文件手动修改：

方法1：使用服务器端包含（SSI）—— 适合需频繁修改的场景 #

Microsoft Help Workshop是支持SSI的，这是最接近「定义常量」的方案：

• 先创建一个名为constants.inc的文本文件，内容如下：

  <!--#set var="PRODUCT_NAME" value="你的产品正式名称" -->
  

• 在每个需要使用产品名称的HTML文件开头，引入这个包含文件：

  <!--#include virtual="/constants.inc" -->
  

• 之后在HTML中所有需要显示产品名称的位置，替换成：

  <!--#echo var="PRODUCT_NAME" -->
  

• 最后别忘了在Help Workshop的项目配置里开启SSI支持（找到类似「Enable Server Side Includes」的选项勾选上），这样编译CHM的时候才会正确解析这些指令。

方法2：用JavaScript动态替换—— 零配置快速实现 #

如果不想折腾SSI的配置，用JS动态替换是个简单的选择：

• 在每个HTML文件的<head>标签里添加这段脚本：

  <script>
  // 定义你的产品名称常量
  const PRODUCT_NAME = "你的产品名称";
  
  window.onload = function() {
    // 方案A：给所有需要显示产品名称的元素加统一class，比如「product-name」
    const nameElements = document.querySelectorAll('.product-name');
    nameElements.forEach(el => el.textContent = PRODUCT_NAME);
    
    // 方案B：全局替换页面中所有匹配的旧名称（注意：可能会误替换无关内容，谨慎使用）
    // document.body.innerHTML = document.body.innerHTML.replace(/旧产品名称/g, PRODUCT_NAME);
  };
  </script>
  

• 然后把HTML中原先写产品名称的地方，改成带指定class的空标签：

  <span class="product-name"></span>
  

  这样页面加载后就会自动填充成你定义的产品名称。

方法3：预编译批量替换—— 适合一次性修改需求 #

如果只是需要把现有所有HTML里的旧产品名称换成新的，不需要后续动态修改，直接用工具批量替换最高效：

• PowerShell脚本（Windows环境）：打开PowerShell，切换到你的HTML文件目录，运行这段脚本（记得替换占位符）：

  $oldProductName = "旧产品名称"
  $newProductName = "新产品名称"
  Get-ChildItem -Filter "*.html" -Recurse | ForEach-Object {
    (Get-Content $_.FullName) -replace $oldProductName, $newProductName | Set-Content $_.FullName
  }
  

• Notepad++批量替换：打开Notepad++，点击「查找」→「在文件中查找」，输入旧产品名称，替换为新产品名称，设置好HTML文件的目录，勾选「递归查找子文件夹」，点击「全部替换」即可。

小提示 #

如果你是用Help Workshop编译CHM文件，不管用哪种方法，记得先处理好所有HTML文件，再导入到项目中编译，确保替换后的内容能正确被打包进CHM里。

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