Electron v14 TypeScript类型定义缺失enableRemoteModule问题咨询

API 探路者

2026-10-5

问题性质说明

这是Electron官方有意推进的破坏性变更，并非v14版本的bug。从Electron 14开始，内置的remote模块被正式完全移除，对应的配置项enableRemoteModule也同步从WebPreferences的TypeScript类型定义中删除，因此传入不存在的属性会触发ts(2322)类型错误。

解决方案

分三种场景适配：

场景1：已经完成remote模块迁移

直接删除webPreferences中的enableRemoteModule: true配置行即可，类型报错会直接消失。

场景2：尚未完成迁移，需要继续使用remote能力

使用官方维护的独立@electron/remote包替代原内置remote模块，操作步骤如下：

安装依赖包：
npm install @electron/remote @types/electron__remote
主进程初始化remote模块：
在主进程入口代码中添加初始化逻辑：

require('@electron/remote/main').initialize()

给目标BrowserWindow启用remote能力：
创建窗口后调用enable方法，示例代码：

const window = new electron.BrowserWindow({
    webPreferences: { 
      plugins: true, 
      nodeIntegration: true, 
      contextIsolation: false,
      backgroundThrottling: false,
      webSecurity: false 
    }
  });
require('@electron/remote/main').enable(window.webContents)

场景3：临时绕过TypeScript校验（不推荐长期使用）

如果需要临时编译通过，可以给webPreferences对象添加类型断言：

const window = new electron.BrowserWindow({
    webPreferences: { 
      plugins: true, 
      nodeIntegration: true, 
      contextIsolation: false,
      enableRemoteModule: true, 
      backgroundThrottling: false,
      webSecurity: false 
    } as Electron.WebPreferences
  });