Electron Forge Typescript+Webpack模板启动报错求助

1. 锁定兼容的插件版本 #

手动修改依赖导致@electron-forge/plugin-webpack版本与Electron Forge核心不兼容是主要原因：

• 找到之前能正常运行的旧项目，查看其package.json中@electron-forge/plugin-webpack的具体版本
• 在新项目的package.json中强制指定该版本，例如：

"devDependencies": {
  "@electron-forge/plugin-webpack": "6.0.0-beta.67"
}

• 清理现有依赖并重新安装：

rm -rf node_modules package-lock.json
npm install

2. 检查并修复Forge配置格式 #

报错提示插件格式不符合要求，需确保forge.config.ts（或.js）中的插件配置结构正确：

• 正确的实例化格式：

import type { ForgeConfig } from '@electron-forge/shared-types';
import { WebpackPlugin } from '@electron-forge/plugin-webpack';

const config: ForgeConfig = {
  plugins: [
    new WebpackPlugin({
      mainConfig: './webpack.main.config.ts',
      renderer: {
        config: './webpack.renderer.config.ts',
        entryPoints: [
          {
            html: './src/index.html',
            js: './src/renderer.ts',
            name: 'main_window',
          },
        ],
      },
    }),
  ],
};

export default config;

• 或正确的对象格式：

plugins: [
  {
    name: '@electron-forge/plugin-webpack',
    config: {
      mainConfig: './webpack.main.config.ts',
      // 其他渲染进程配置
    }
  }
]

避免出现数组嵌套、格式缺失等错误。

3. 用正确方式修复依赖漏洞 #

不要手动修改package-lock.json，改用npm-force-resolutions强制更新高危依赖：

• 在package.json中添加以下配置：

"resolutions": {
  "got": "^11.8.5",
  "minimatch": "^3.0.5"
},
"scripts": {
  "preinstall": "npx npm-force-resolutions"
}

• 清理依赖后重新安装：

rm -rf node_modules package-lock.json
npm install

此方法可在不破坏原有依赖兼容性的前提下修复漏洞。

4. 重新初始化兼容版本的模板 #

若以上方法无效，直接使用旧版本的Electron Forge模板创建项目：

npx create-electron-app@<旧版本号> my-new-app --template=typescript-webpack

将旧项目的业务代码迁移至新项目即可。

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