初始化electron项目运行后报错 electron uninstall 解决方法
ReactPress地址：https://github.com/fecommunity/reactpress 欢迎Star
问题描述
最近开发ReactPress的时候，首次初始化electron-vite项目，运行pnpm dev后出现了报错，一大堆，关键的就是提到了electron uninstall这个错误。
解决方法
如果是在node环境下，运行命令 node .\node_modules\electron\install.js 后，项目就可以正常启动了。
问题背景
最近在初始化一个新的 electron-vite 项目时，运行 pnpm dev 命令后遇到了一系列错误，其中最关键的报错信息提到了 electron uninstall。这个错误通常发生在首次创建或克隆 Electron 项目时，特别是在依赖安装完成后尝试启动开发环境的情况下。
错误现象
当你满怀期待地执行 pnpm dev 命令，准备开始 Electron 开发之旅时，却在控制台看到了类似以下的错误信息：
Error: Cannot find module 'electron'
// 或者
Error: Electron failed to install correctly
// 或者直接提到 electron uninstall 相关错误
这些错误通常伴随着一堆堆栈跟踪信息，让新手开发者感到困惑。
问题根源
这个问题的根本原因在于 Electron 的安装机制。Electron 包在安装过程中需要执行一个后安装脚本（post-install script）来下载实际的 Electron 二进制文件。有时候，由于网络问题、权限限制或安装过程被中断，这个步骤可能没有正确完成。
解决方案
方法一：手动运行安装脚本（推荐）
最简单的解决方法是手动运行 Electron 的安装脚本：
node ./node_modules/electron/install.js
这个命令会：
- 检查当前平台（Windows、macOS 或 Linux）
- 下载对应平台的 Electron 二进制文件
- 将其安装到项目的
node_modules目录中
方法二：重新安装依赖
如果上述方法不奏效，可以尝试删除 node_modules 文件夹并重新安装依赖：
# 删除 node_modules
rm -rf node_modules
# 或者 Windows 系统使用
rmdir /s node_modules# 重新安装依赖
pnpm install
方法三：清除缓存并重新安装
有时候，缓存可能导致安装问题：
# 清除 npm/pnpm 缓存
pnpm store prune
# 或者
npm cache clean --force# 然后重新安装依赖
pnpm install
方法四：检查网络和代理设置
如果你在公司网络或使用代理，可能需要检查网络设置：
# 设置 Electron 镜像（中国大陆用户）
npm config set electron_mirror https://npmmirror.com/mirrors/electron/# 然后重新运行安装
node ./node_modules/electron/install.js
预防措施
为了避免将来再次遇到这个问题，可以考虑以下预防措施：
-
使用可靠的网络环境：在安装 Electron 项目时确保网络连接稳定
-
设置环境变量：对于经常需要安装 Electron 的环境，可以设置镜像源：
# 在 .bashrc、.zshrc 或环境变量中设置 export ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ -
使用 .npmrc 配置：在项目根目录创建
.npmrc文件：electron_mirror=https://npmmirror.com/mirrors/electron/ -
考虑使用 yarn 或 pnpm：这些包管理器有时能更好地处理依赖安装
深入理解
为什么需要这个额外的安装步骤？这是因为 Electron 实际上由两部分组成：
- 包含 JavaScript API 的 npm 包
- 平台特定的二进制可执行文件
当你安装 electron npm 包时，它只包含了 JavaScript 部分。实际的 Chromium + Node.js 运行时需要在安装后单独下载，这就是 install.js 脚本的作用。
总结
遇到 Electron uninstall 错误时不必惊慌，这通常只是 Electron 二进制文件没有正确下载导致的。通过运行 node ./node_modules/electron/install.js 命令，大多数情况下问题都能迎刃而解。如果问题依然存在，按照上述方法一步步排查，通常能找到解决方案。
希望这篇博客能帮助遇到类似问题的开发者顺利开始他们的 Electron 开发之旅！