Electron关闭context isolation后打包应用出现空白窗口问题

问题场景 #

• 为解决IPC解析大Excel时内存翻倍的问题，将contextIsolation设为false
• 使用Node内置模块（如fs）时，打包后的应用运行完全正常
• 引入node-xlsx或read-excel-file/node这类第三方模块后，打包好的应用打开是空白窗口，但用npm start在开发模式下运行一切正常
• 试过非默认导入的方式，问题依旧没解决
• 渲染进程的导入代码如下：
  

可行解决办法 #

1. 修正打包工具配置（以electron-builder为例） #

确保第三方模块被完整打包进应用，在package.json的build字段里加这些配置：

"build": {
  "extraResources": [
    {
      "from": "node_modules/node-xlsx",
      "to": "node_modules/node-xlsx"
    },
    {
      "from": "node_modules/read-excel-file",
      "to": "node_modules/read-excel-file"
    }
  ]
}

如果用的是electron-packager，打包命令里别加会排除这些模块的--ignore规则，或者直接加--no-prune防止打包时自动删除依赖。

2. 改用CommonJS的require导入 #

开发模式可能兼容ES模块导入，但打包后Electron对ES模块的处理容易出问题，把导入代码改成这样：

const nodeXlsx = require('node-xlsx');
// read-excel-file的写法
const readExcelFile = require('read-excel-file/node');

3. 确认主进程窗口的Node集成配置 #

虽然已经开了contextIsolation: false，但要确保nodeIntegration是true，主进程里的窗口配置要写全：

const mainWindow = new BrowserWindow({
  // 其他窗口配置
  webPreferences: {
    contextIsolation: false,
    nodeIntegration: true
    // 要是用了remote模块，Electron12+还要加enableRemoteModule: true
  }
});

4. 清理缓存后重新打包 #

• 删除node_modules、打包输出目录（比如dist）、package-lock.json
• 重新执行npm install，再跑打包命令

5. 处理模块的二进制文件 #

有些第三方模块带.node后缀的二进制文件，electron-builder需要单独配置解压，在package.json里加：

"build": {
  "asarUnpack": [
    "node_modules/node-xlsx/**/*.node",
    "node_modules/read-excel-file/**/*.node"
  ]
}

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