Electron打包踩坑实录：为什么你的模块总是找不到？（附解决方案）

Electron打包模块丢失问题深度解析与实战解决方案

从一次深夜调试说起

凌晨三点，屏幕上的红色报错信息格外刺眼——"Cannot find module 'xxx'"。这已经是本周第三次遇到类似的Electron打包问题了。作为一名长期奋战在Electron开发一线的工程师，我深知这类问题的顽固性。不同于普通的Node.js应用，Electron的打包过程涉及主进程、渲染进程、依赖管理等多重机制，稍有不慎就会导致模块丢失。本文将系统梳理Electron打包过程中模块查找失败的六大核心原因，并提供经过实战验证的解决方案。

1. 依赖管理：devDependencies与dependencies的陷阱

1.1 依赖分类的本质区别

许多开发者容易忽视npm中devDependencies和dependencies的根本差异：

{
  "dependencies": {
    "electron": "^25.0.0",
    "express": "^4.18.2"
  },
  "devDependencies": {
    "electron-builder": "^24.4.0",
    "typescript": "^5.0.4"
  }
}

关键规则：

• 生产依赖（dependencies）：会被打包进最终应用
• 开发依赖（devDependencies）：仅用于开发阶段，不会被打包

1.2 典型误区和解决方案

常见错误场景：

1. 将运行时必需的模块错误放入devDependencies
2. 混淆构建工具与运行时依赖
3. 多进程应用中依赖放置不当

解决方案表格：