electron 打包后 提示.nodeis not a valid Win32 application.

在开发串口通信应用时，很多开发者可能会遇到跨平台打包的问题，特别是在使用 Electron + Vite + Vue3 + SerialPort 框架时，可能会在 macOS 上打包成功，但在 Windows 平台上运行时报错。本文将分享如何解决 SerialPort 在 Windows 上打包后的错误问题。

开发环境：

• 开发框架：Electron + Vite + Vue3 + SerialPort
• 开发电脑：macOS
• Node.js 版本：22.7.0

问题描述：

在开发串口通信的应用时，macOS 上打包并运行一切正常，但在 Windows 上运行时，报错信息如下：

经过排查，发现这个问题出现在 SerialPort 包的引入上。

原因分析：

SerialPort 是一个与硬件交互的 Node.js 包，需要在不同平台上编译原生代码。为了能够在 Windows 上正常运行，必须确保它的原生依赖在打包时能够正确构建。

官方文档提到：

• node-gyp 需要正确配置，并且版本必须为 7.x。
• 还需要使用 electron-rebuild 来重建原生模块。

尽管按照步骤安装了 node-gyp 7.x 版本和 electron-rebuild，但问题仍未解决。

解决方案：

经过多次尝试，最终将 Node.js 版本降级为 16.15.0 后，问题得以解决。

步骤：

    1.vite.config.js 配置

build: {
    rollupOptions: {
      external: ['serialport']
    }
  }

2. package.json配置

"build": {
    "asar": true,
    "npmRebuild": false,
    "extraResources": [
      {
        "from": "node_modules/serialport",
        "to": "node_modules/serialport"
      }
    ],
    "productName":

 

3.安装正确版本的 Node.js 将 Node.js 降级到 16.15.0 版本。可以通过 nvm（Node 版本管理工具）来方便地切换 Node 版本：

nvm install 16.15.0
nvm use 16.15.0

4.重建原生模块 使用 electron-rebuild 重新构建与 Electron 兼容的原生模块：

npx electron-rebuild

5.打包项目 最后，使用你的打包工具进行打包。此时，打包后的应用在 Windows 平台上应该可以正常运行

总结：

如果在使用 SerialPort 进行跨平台开发时，遇到打包后在 Windows 上无法运行的问题，可以通过以下几点来解决：

• 确保 node-gyp 和 electron-rebuild 正确安装。
• 如果问题仍然存在，尝试将 Node.js 版本降级到 16.15.0，这一版本在处理原生模块时更加稳定。

这个方案成功解决了在 macOS 上打包 Windows 应用时出现的 SerialPort 兼容性问题。希望这个教程对你有所帮助！