Electron-Builder跨平台构建问题解析：macOS构建Windows应用的特殊情况

在跨平台开发中，Electron-Builder是一个常用的打包工具，但开发者在macOS（特别是ARM架构的M系列芯片）上构建Windows应用时可能会遇到一个特殊问题：生成的安装包在Windows系统上安装后，程序目录中仅包含卸载程序，而缺少主应用程序文件。这种现象并非简单的构建失败，而是涉及架构兼容性的深层问题。

问题本质分析

经过技术验证，这个问题的根源在于架构匹配机制。Electron-Builder默认会根据构建主机的架构生成对应架构的二进制文件。当在ARM架构的macOS设备（如M1/M2芯片的Mac）上构建Windows应用时，工具会默认生成ARM架构的Windows安装包，而非开发者预期的x64架构包。

这种架构不匹配会导致以下现象：

1. 安装包能够正常生成且可以在Windows系统运行安装程序
2. 安装过程看似成功完成
3. 但最终安装目录中仅包含卸载程序（uninstall.exe）
4. 主应用程序文件缺失

解决方案

解决这个问题的关键在于明确指定目标架构。开发者需要在构建命令中显式声明目标平台架构参数：

electron-builder --win --x64

这个命令中的--x64参数强制构建系统生成x86-64架构的Windows应用，确保兼容大多数Windows设备。

技术背景延伸

1. 架构兼容性：Windows系统虽然支持ARM架构，但大多数Electron应用仍以x64架构为主流目标。ARM架构的Windows设备通过兼容层运行x64应用，但反向兼容性较差。

2. 构建系统行为：Electron-Builder的默认架构继承机制旨在简化同架构开发流程，但在跨平台场景下可能产生非预期结果。

3. 安装包机制：NSIS安装程序在架构不匹配时仍能完成部分安装流程，这解释了为何会出现"半成功"的安装现象。

最佳实践建议

1. 在CI/CD管道中明确指定目标架构参数
2. 对于跨平台构建，建议在配置文件中固定目标架构：

"build": {
  "win": {
    "target": "nsis",
    "arch": "x64"
  }
}

3. 定期验证构建产物是否能在目标平台正常运行

总结