如何修改WiX项目避免VS2022 CRT合并模块覆盖新版msvcp140.dll

问题背景 #

使用Visual Studio 2022 v17.4（MSVC工具版本14.34.31933）构建C++应用，通过WiX Toolset的Microsoft_VC143_CRT_x64.msm合并模块打包VC Redistributable。但安装包会将系统中新版的C:\Windows\System32\msvcp140.dll（版本14.40.33810.0）覆盖为旧版本14.34.31931.0，导致新版VS构建的程序因std::mutex::lock()兼容性问题崩溃，且安装日志显示未识别到已存在的新版Redistributable。

解决方案 #

1. 为合并模块添加版本检测条件 #

通过注册表检测系统已安装的VC143 Redist版本，仅当系统版本低于当前MSM对应版本时才安装合并模块：

• 在Product.wxs的Feature节点中添加条件判断，当系统已有版本≥当前版本时，跳过该Feature的安装：

<Feature Id="VCRedistFeature" Title="VC Redistributable" Level="1">
  <!-- 当系统已安装的VC143 x64版本 ≥ 14.34.31931.0时，不安装此Feature -->
  <Condition Level="0">
    (VersionNT >= 601) AND 
    (REGISTRYVALUE("HKLM\SOFTWARE\Microsoft\VisualStudio\14.0\VC\Runtimes\x64\Version") >= "14.34.31931.0")
  </Condition>
  <MergeRef Id="VCRedistMergeModule" /> <!-- 你的合并模块引用 -->
</Feature>

• 若为32位安装包，需修改注册表路径为HKLM\SOFTWARE\WOW6432Node\Microsoft\VisualStudio\14.0\VC\Runtimes\x64\Version

2. 确保文件的版本替换策略正确 #

确认合并模块中文件的安装属性为仅替换较旧版本：

• Windows Installer默认对版本化文件（带版本号的DLL/EXE）会自动比较版本，仅当安装包内文件版本高于系统现有版本时才替换。若合并模块存在异常，可手动在WiX中指定文件替换规则：

<Component Id="VCRedistFileComponent" Guid="*">
  <File Source="path\to\msvcp140.dll" KeyPath="yes"
        Version="14.34.31931.0"
        Replace="ifLessThan" /> <!-- 仅当系统文件版本更低时替换 -->
</Component>

注：优先使用合并模块+条件判断的方式，避免手动维护单个文件。

3. 改用WiX VCRuntimeExtension扩展（推荐） #

WiX提供官方扩展自动处理VC Redist的版本检测、安装逻辑，比手动引用合并模块更可靠：

1. 在WiX项目中添加对WixVcruntimeExtension.dll的引用
2. 在Product.wxs中引入命名空间并配置VCRuntimeFeature：

<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi"
     xmlns:vcruntime="http://schemas.microsoft.com/wix/VCRuntimeExtension">
  <Product Id="*" Name="YourApp" Language="1033" Version="1.0.0.0" Manufacturer="YourCompany" UpgradeCode="YOUR-UPGRADE-CODE">
    <Package InstallerVersion="200" Compressed="yes" InstallScope="perMachine" />
    
    <Feature Id="MainFeature" Level="1">
      <ComponentGroupRef Id="YourAppComponents" />
      <!-- 指定需要安装的VC Redist版本，自动检测系统现有版本 -->
      <vcruntime:VCRuntimeFeature PackageFile="vc_redist.x64.exe" Version="14.34.31933" />
    </Feature>
  </Product>
</Wix>

此方式会自动检查系统中已安装的VC Redist版本，仅当系统版本低于指定版本时执行安装，同时使用官方VC Redist安装包，支持修复、卸载等完整生命周期管理。

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