如何基于Wix Toolset v4创建多语言Bundle安装程序？

错误原因 #

编译提示的本地化标识符重复，是因为不同语言的WXL文件中使用了相同的标识符名称（比如Caption），但编译时这些标识符被合并到同一命名空间下，导致冲突；或是你在Bundle配置里错误地将多语言WXL同时作为全局本地化文件引入，未按语言做隔离处理。

正确配置步骤 #

1. 按语言拆分WXL文件 #

给每种语言单独创建WXL文件，文件名建议包含语言代码，例如：

• en-us.wxl（对应1033语言）
• zh-cn.wxl（对应2052语言）
• de-de.wxl（对应1031语言）

每个WXL内的标识符名称保持一致，只修改对应语言的翻译值：
en-us.wxl示例：

<Localization xmlns="http://schemas.microsoft.com/wix/2006/localization" Culture="en-us">
  <String Id="Caption">Setup Wizard</String>
</Localization>

zh-cn.wxl示例：

<Localization xmlns="http://schemas.microsoft.com/wix/2006/localization" Culture="zh-cn">
  <String Id="Caption">安装向导</String>
</Localization>

2. 在Bundle中正确关联多语言文件 #

不要将所有WXL直接通过<LocalizationFile>全局引入，而是作为BootstrapperApplication的Payload按语言路径打包，并定义支持的语言：

<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
  <Bundle Name="MyAppSetup" Version="1.0.0.0" Manufacturer="MyCorp">
    <BootstrapperApplicationRef Id="ManagedBootstrapperApplicationHost">
      <Payload SourceFile="MyBA.dll" />
      <Payload SourceFile="en-us.wxl" Compressed="yes" Name="1033\en-us.wxl" />
      <Payload SourceFile="zh-cn.wxl" Compressed="yes" Name="2052\zh-cn.wxl" />
      <!-- 其他语言的Payload配置 -->
    </BootstrapperApplicationRef>

    <!-- 声明支持的语言 -->
    <BundleLocalization Culture="en-us" />
    <BundleLocalization Culture="zh-cn" />
    <BundleLocalization Culture="de-de" />

    <!-- 其他Bundle配置（如Chain、Variables等） -->
  </Bundle>
</Wix>

3. 在自定义BootstrapperApplication中处理语言逻辑 #

• 自动匹配系统语言：BA启动时，通过Engine.StringVariables["WixBundleCulture"]获取系统语言代码，加载对应路径下的WXL文件。
• 手动语言选择UI：若需要用户手动选择，在BA初始化阶段弹出语言选择对话框，根据用户选择设置WixBundleCulture变量后，再加载对应本地化资源。

4. 编译阶段避坑 #

确保编译时多语言WXL是作为特定语言的Payload打包，而非全局引入。如果使用WiX的MSBuild项目，不要将所有WXL都设为<LocalizationFile>，而是通过Payload方式包含。

额外注意事项 #

• 所有语言WXL中的标识符ID必须完全一致，才能在切换语言时正确替换文本。
• 单个WXL文件内不可重复定义相同的标识符ID。
• 测试时可通过命令行参数强制指定语言，比如MySetup.exe -culture:zh-cn，验证本地化效果。

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