WSL2 Ubuntu环境下Vite项目npm run dev报write EPIPE错误求助

问题重现 #

在基于Ubuntu的WSL2环境中启动Vite开发服务器时，执行npm run dev反复触发以下错误，最终服务终止：

5:24:57 PM [vite] Pre-transform error: The service was stopped: write EPIPE
# -- 省略重复日志 --
Error: The service was stopped: write EPIPE
    at /home/jimii/Documents/crew/smithii_tools_front_v2/node_modules/vite/node_modules/esbuild/lib/main.js:993:26

已尝试删除package-lock.json和node_modules重新安装，但问题未解决。

解决步骤 #

• 禁用esbuild服务模式
  在项目根目录的vite.config.js中添加配置，强制esbuild使用子进程而非服务模式，避免IPC通信故障：

  import { defineConfig } from 'vite'
  
  export default defineConfig({
    esbuild: {
      service: false
    }
  })
  

• 迁移项目到WSL本地文件系统
  将项目从Windows挂载目录（如/mnt/c/...）移动到Ubuntu本地目录（如/home/your-username/projects/），Windows文件系统的IO延迟和兼容性问题容易导致esbuild服务崩溃。

• 调整WSL2资源分配
  在Windows系统的C:\Users\<你的用户名>\.wslconfig文件中添加资源限制（如果不存在则新建），避免内存/CPU不足导致服务终止：

  [wsl2]
  memory=4GB
  processors=2
  

  保存后执行wsl --shutdown重启WSL，再重新启动项目。

• 清除esbuild缓存并重装依赖

  rm -rf ~/.cache/esbuild
  rm -rf node_modules package-lock.json
  npm install
  

• 升级Node.js版本
  使用nvm切换到LTS版本的Node.js，避免版本兼容性问题：

  nvm install 20 --lts
  nvm use 20
  npm install
  

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