启动Electron+Vite开发服务器及应用时遇Error: Electron uninstall错误

• 彻底清理Electron残留文件

  • 删除项目根目录下的node_modules文件夹
  • 删除对应包管理器的锁文件：package-lock.json（npm）、pnpm-lock.yaml（pnpm）、yarn.lock（yarn）
  • 清理包管理器缓存：
    • npm：npm cache clean --force
    • pnpm：pnpm store prune
    • yarn：yarn cache clean
  • 删除全局Electron缓存目录：
    • Windows：C:\Users\<你的用户名>\AppData\Local\electron
    • macOS：~/Library/Caches/electron
    • Linux：~/.cache/electron

• 重新安装兼容版本的依赖

  • 先卸载项目中的Electron：npm uninstall electron / pnpm remove electron / yarn remove electron
  • 安装指定稳定版Electron（以最新稳定版为例）：npm install electron@latest --save-dev（替换前缀为pnpm/yarn即可）
  • 若为Vite集成项目，确认vite-plugin-electron版本与Electron版本兼容

• 排查环境权限与网络问题

  • 确保当前用户拥有项目目录及包管理器全局目录的读写权限
  • 临时关闭代理或防火墙，避免阻止Electron包的下载

• 验证基础环境是否正常

  • 创建最小化Electron项目测试：
    1. 新建文件夹并初始化：npm init -y
    2. 安装Electron：npm install electron --save-dev
    3. 在package.json添加启动脚本："start": "electron ."
    4. 创建main.js文件：

       const { app, BrowserWindow } = require('electron');
       function createWindow() {
         const win = new BrowserWindow({ width: 800, height: 600 });
         win.loadFile('index.html');
       }
       app.whenReady().then(createWindow);
       

    5. 创建index.html文件：

       <!DOCTYPE html>
       <html>
         <body><h1>Test Electron</h1></body>
       </html>
       

    6. 运行npm start，若能正常启动则说明全局环境无问题，需排查原项目配置

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