Windows10下Vite项目执行npm run dev命令报错求助

问题详情 #

无论新建还是已有Vite Vue项目，每次执行npm run dev或其他npm命令都会触发以下错误：

"C:\Program Files\nodejs\npm.cmd" run dev

> my-app@0.0.0 dev
> vite

failed to load config from C:\Users\location\to\prject\vite.config.js
error when starting dev server:
Error: The service was stopped
    at C:\Users\location\to\prject\node_modules\esbuild\lib\main.js:1083:25
    at responseCallbacks.<computed (C:\Users\location\to\prject\node_modules\esbuild\lib\main.js:703:9)
    at Socket.afterClose (C:\Users\location\to\prject\node_modules\esbuild\lib\main.js:693:28)
    at Socket.emit (node:events:525:35)
    at endReadableNT (node:internal/streams/readable:1359:12)
    at process.processTicksAndRejections (node:internal/process/task_queues:82:21)

环境信息 #

• 系统：Windows 10
• Node.js版本：v18.16.0
• npm版本：v9.5.1
• 项目package.json内容：

{
  "name": "",
  "version": "0.0.0",
  "private": true,
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "preview": "vite preview"
  },
  "dependencies": {
    "pinia": "^2.1.4",
    "vue": "^3.3.4",
    "vue-router": "^4.2.4",
    "vuetify": "^3.3.9"
  },
  "devDependencies": {
    "@vitejs/plugin-vue": "^4.2.3",
    "vite": "^4.4.6"
  }
}

目前仅能通过删除node_modules并重装依赖临时解决，但无法根治，需彻底解决方案。

彻底解决方法 #

• 清理esbuild全局缓存
  Windows系统中esbuild的全局缓存位于%LOCALAPPDATA%\esbuild，直接删除该文件夹，清除损坏的缓存文件。

• 锁定esbuild版本
  在项目package.json的devDependencies中明确添加esbuild的稳定版本，例如：

  "devDependencies": {
    "@vitejs/plugin-vue": "^4.2.3",
    "vite": "^4.4.6",
    "esbuild": "^0.18.20"
  }
  

  执行npm install重新安装依赖，避免Vite自动拉取的兼容版本出现问题。

• 禁用esbuild服务模式
  在项目的vite.config.js中添加配置，关闭esbuild的服务模式，改用进程内编译：

  import { defineConfig } from 'vite'
  import vue from '@vitejs/plugin-vue'
  
  export default defineConfig({
    plugins: [vue()],
    esbuild: {
      service: false
    }
  })
  

• 排查杀毒软件/防火墙干扰
  Windows Defender或第三方杀毒软件可能误拦截esbuild的进程，将项目目录及node_modules文件夹加入杀毒软件白名单，或临时关闭杀毒软件测试是否解决问题。

• 更换包管理器
  尝试使用pnpm替代npm，避免npm缓存或安装机制的潜在问题：

  1. 全局安装pnpm：npm install -g pnpm
  2. 删除项目的node_modules和package-lock.json
  3. 执行pnpm install安装依赖，再运行pnpm run dev

• 更新Node.js到最新LTS版本
  升级Node.js至最新LTS版本（如v20.x），修复旧版本Node.js与esbuild的兼容性问题。

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