Ubuntu22.04下Electron-Forge打包Win32 Squirrel分发包失败排查

问题根源 #

Electron的Squirrel.Windows打包工具在Linux环境下生成Windows安装包时，依赖Mono运行时处理.NET相关的打包逻辑，系统未安装Mono或Mono不在PATH中时就会触发这个错误。

解决步骤 #

• 安装完整的Mono运行时：

  sudo apt update && sudo apt install mono-complete
  

• 验证Mono安装：执行mono --version，确认输出正常版本信息，确保Mono已加入系统PATH。
• 重新执行打包命令：yarn make --platform=win32

问题根源 #

Wine对Electron的GPU渲染兼容性有限，加上默认环境可能缺少必要的Windows依赖组件、Wine版本过旧或系统显卡驱动不完善，都会导致GPU进程启动失败。

调试与解决步骤 #

1. 临时禁用GPU加速
   先通过命令行参数跳过GPU渲染验证是否是GPU兼容性问题：

   wine your-app.exe --disable-gpu --disable-gpu-compositing --no-sandbox
   

   如果能正常运行，说明问题出在GPU渲染适配，后续可以考虑在应用中默认禁用GPU（仅针对Wine环境），或者优化Wine的GPU配置。

2. 升级Wine到Staging版本
   Ubuntu 22.04默认的Wine版本兼容性较差，Staging版本包含更多针对Windows应用的补丁：

   # 添加Wine官方源
   sudo dpkg --add-architecture i386
   sudo mkdir -pm755 /etc/apt/keyrings
   sudo wget -O /etc/apt/keyrings/winehq-archive.key https://dl.winehq.org/wine-builds/winehq.key
   sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/jammy/winehq-jammy.sources
   # 安装Staging版本
   sudo apt update && sudo apt install --install-recommends winehq-staging
   

3. 安装必要的Windows依赖组件
   使用winetricks安装Electron常用的依赖：

   # 先安装winetricks
   sudo apt install winetricks
   # 安装核心依赖
   winetricks corefonts vcrun2019 dxvk
   

   • corefonts：解决字体渲染问题
   • vcrun2019：Electron依赖的VC++运行库
   • dxvk：改善Wine的DirectX/Vulkan GPU兼容性

4. 更新系统显卡驱动

   • NVIDIA用户：安装官方专有驱动（sudo apt install nvidia-driver-535，版本号以当前最新为准）
   • AMD/Intel用户：更新Mesa驱动（sudo apt install mesa-utils libgl1-mesa-dri mesa-vulkan-drivers）

5. 生成详细日志定位深层问题
   如果以上步骤无效，生成Wine调试日志获取具体报错：

   WINEDEBUG=+all wine your-app.exe 2>&1 > wine-debug.log
   

   查看日志中GPUProcess相关的报错信息，比如缺少特定DLL、显卡驱动调用失败等，针对性解决。

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