多版本依赖共存时，如何配置electron-forge与webpack加载指定版本模块

核心冲突逻辑 #

• Electron Forge 工具链运行在原生 Node 环境，依赖根目录下的 jsonfile@4.0.0 版本，手动删除该目录会直接中断 Forge 的启动流程
• IPFS 运行时链路的 fs-extra 嵌套依赖指向 jsonfile@6.1.0，该版本新增了 utils 导出能力
• 默认 Webpack 模块解析逻辑优先匹配根目录的 jsonfile@4.0.0，导致 IPFS 运行时找不到高版本独有的导出，触发 Cannot find module 'jsonfile/utils' 报错

具体配置步骤 #

1. 主进程 Webpack 增加别名映射 #

在 tools/forge/forge.config.js 的主进程构建配置中，为打包流程单独设置模块别名，不影响 Forge 自身的原生模块解析：

const path = require('path');

module.exports = {
  // 原有 Forge 配置保持不变
  plugins: [
    {
      name: '@electron-forge/plugin-webpack',
      config: {
        mainConfig: {
          // 保留原有配置项，仅追加 resolve 配置
          resolve: {
            alias: {
              // 强制 fs-extra 关联的 jsonfile 引用指向嵌套安装的 v6 版本
              'jsonfile$': path.resolve(__dirname, '../../node_modules/fs-extra/node_modules/jsonfile/index.js'),
              'jsonfile/utils': path.resolve(__dirname, '../../node_modules/fs-extra/node_modules/jsonfile/utils.js'),
            }
          },
          // 保留原有 externals 配置，追加工具链相关模块不打入产物
          externals: [
            '@electron/get',
            '@electron-forge/**'
          ]
        },
        // 渲染进程配置保持原有逻辑不变
      }
    }
  ]
}

该别名仅对 Webpack 打包流程生效。Forge 自身的运行逻辑不经过 Webpack 处理，依然会正常通过 Node 原生模块查找逻辑加载根目录下的 jsonfile@4.0.0，不会触发工具链报错。

2. 调整模块解析优先级 #

在 Webpack 主进程配置中，将 IPFS 依赖的嵌套 node_modules 目录设置为更高的解析权重，避免模块查找时错误命中根目录的低版本依赖：

resolve: {
  // 解析顺序从高到低排列
  modules: [
    path.resolve(__dirname, '../../node_modules/ipfs-utils/node_modules'),
    path.resolve(__dirname, '../../node_modules/ipfs-core/node_modules'),
    'node_modules'
  ],
  // 保留上述别名配置
}

3. 校验主进程构建配置 #

确认主进程 Webpack 配置匹配 Electron 主进程的运行环境，避免模块被错误改写：

// 主进程配置段
target: 'electron-main',
node: {
  // 关闭 Webpack 对 Node 全局变量的改写，保持原生运行时行为
  __dirname: false,
  __filename: false
}

效果验证 #

• 启动开发命令 yarn start，确认 Forge 可正常完成启动流程，无 Cannot find module 'jsonfile' 的工具链报错
• 在主进程代码中引入 IPFS 模块，确认打包产物运行时无 Cannot find module 'jsonfile/utils' 的报错
• 执行打包命令 yarn make，确认全流程无依赖版本冲突问题

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