Windows环境下运行Vite(Vue.js) dev命令报错求助

• 清理残留依赖与缓存

  • 删除项目根目录下的node_modules文件夹
  • 删除package-lock.json（用yarn则删yarn.lock）
  • 执行命令npm cache clean --force清空npm缓存
  • 重新运行npm install安装依赖

• 排查硬编码路径

  • 检查项目代码、配置文件里的绝对路径，比如Linux风格的/xxx/xxx，全部替换成相对路径，或者用Node.js的path模块动态生成（例如path.join(__dirname, './src/utils')）
  • 重点检查vite.config.js/vite.config.ts中的root、resolve.alias等配置项，确保没有硬写的Linux路径

• 修复全局工具路径与环境变量

  • 确认Node.js、npm的安装路径不含空格或特殊字符（比如别装在C:\Program Files\nodejs，换成C:\NodeJS这类路径）
  • 检查系统环境变量PATH，确保Node.js和npm的路径在最前面，没有旧版本或冲突路径

• 调整文件权限与目录

  • 把项目移到非系统保护目录（比如不要放在C:\Windows或Program Files），避免权限问题
  • 检查Linux下的隐藏配置文件（比如.env、.eslintrc）是否被Windows忽略，手动复制或重新创建这些文件

• 验证基础环境

  • 创建全新Vite项目测试：npm create vite@latest test-demo -- --template vue
  • 进入项目执行npm install && npm run dev，如果还是报错，卸载重装Node.js（选LTS版本，安装时务必勾选"Add to PATH"）

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