WiX安装时如何在同名文件被覆盖前将现有文件复制到子目录

两个方案失效的核心原因都是Windows Installer（WiX底层调用的安装服务）的执行时序和默认文件处理规则问题：

1. 批处理CustomAction方案的问题你定位准确：如果批处理文件本身是安装包要部署的文件，它必须等InstallFiles阶段执行完才能落地到本地，而此时同阶段的新file.json已经覆盖了旧文件，备份逻辑完全失效。
2. 原生<CopyFile>方案出现“只备份旧文件、新文件不覆盖”的原因：
   • 你把<CopyFile>放在了独立Component中，没有和待部署的新file.json绑定，默认执行时机早于新版本文件的覆盖判定流程；
   • Windows Installer对json这类不带版本信息的非可执行文件，默认启用“保护用户数据”规则：如果目标路径下的文件修改时间晚于文件创建时间（即判定为用户修改过的配置文件），会直接跳过新文件写入步骤，不会执行覆盖。

方案1：纯WiX原生实现（推荐，无自定义脚本依赖） #

不需要额外写脚本，直接通过调整组件配置和安装时序实现，稳定性最高：

1. 调整目录定义，提前声明备份目录，并给备份目录加自动创建逻辑，避免复制时因目录不存在报错：

<Directory Id="ProgramFolder" Name="Program">
  <Directory Id="BackupFolder" Name="Backup">
    <Component Id="Cmp_CreateBackupDir" Guid="YOUR-COMPONENT-GUID" KeyPath="yes">
      <CreateFolder />
    </Component>
  </Directory>
</Directory>

2. 把<CopyFile>直接和新file.json放在同一个Component下，给非版本化的json文件显式指定版本标识，绕过默认的“跳过用户修改文件”规则：

<Component Id="Cmp_FileJson" Guid="YOUR-COMPONENT-GUID" Directory="ProgramFolder">
  <File Id="File_NewJson" 
        KeyPath="yes" 
        Source="path\to\your\build\file.json"
        Vital="yes"
        DefaultVersion="1.0.0.0" /> <!-- 关键：给无版本文件加标识，让MSI正常执行覆盖逻辑 -->
  <CopyFile Id="Copy_BackupOldJson"
            SourceDirectory="ProgramFolder"
            SourceName="file.json"
            DestinationDirectory="BackupFolder"
            DestinationName="file.json"
            Delete="no" />
</Component>

3. 调整安装执行时序，把旧版本卸载动作挪到文件安装前，确保备份逻辑在新文件写入前执行：

<InstallExecuteSequence>
  <RemoveExistingProducts After="InstallValidate" />
</InstallExecuteSequence>

该配置下的执行顺序为：创建备份目录 → 复制磁盘上现存的旧file.json到备份路径 → 写入新版本file.json覆盖原路径文件，完全符合需求。

方案2：内嵌命令自定义动作（适合不想修改文件规则的场景） #

不需要把批处理文件打包进安装包，直接用内嵌cmd命令执行备份，从根源避免脚本落地的时序冲突：

1. 定义即时执行的自定义动作，直接调用cmd执行复制逻辑：

<CustomAction Id="CA_BackupOldJson" 
              Directory="ProgramFolder"
              ExeCommand='cmd /c "if not exist Backup mkdir Backup & if exist file.json copy /y file.json Backup\file.json"'
              Execute="immediate"
              Return="ignore" />

2. 把动作绑定到InstallFiles之前执行，仅在安装/升级时触发，卸载时不执行：

<InstallExecuteSequence>
  <Custom Action="CA_BackupOldJson" Before="InstallFiles">NOT REMOVE~="ALL"</Custom>
</InstallExecuteSequence>

• 所有备份逻辑必须放在InstallFiles动作之前执行，一旦进入文件落地阶段，旧文件会被直接覆盖，后续备份无意义。
• 不要把<CopyFile>放在和目标文件无关的独立Component中，否则安装器会把复制动作和组件安装时机绑定，很容易出现时序错位。
• 所有配置类非版本文件如果需要强制覆盖，一定要显式加DefaultVersion属性，否则MSI默认的用户数据保护规则会直接跳过文件写入，不会给出任何提示。

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