克隆Laravel项目后无法执行npm run dev，请求技术帮助

问题场景 #

克隆朋友的Laravel项目后，页面提示：

Vite manifest not found at: D:\laravel\PBL-Kelompok-5-2\public\build/manifest.json
Start the development server
Run npm run dev in your terminal and refresh the page.

执行npm install后显示安装完成，但运行npm run dev时反复报错：

node:internal/modules/cjs/loader:1147
  throw err;
  ^
Error: Cannot find module 'D:\laravel\PBL-Kelompok-5-2\node_modules\npm\bin\npm-cli.js'
    at Module._resolveFilename (node:internal/modules/cjs/loader:1144:15)
    at Module._load (node:internal/modules/cjs/loader:985:27)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:135:12)
    at node:internal/main/run_main_module:28:49 {
  code: 'MODULE_NOT_FOUND',
  requireStack: []
}

已尝试关闭Windows防火墙，问题仍存在。

解决步骤 #

1. 清理缓存并重新安装依赖 #

• 删除项目根目录下的node_modules文件夹和package-lock.json文件
• 执行全局缓存清理：

  npm cache clean --force
  

• 重新安装项目依赖：

  npm install
  

2. 修复npm路径异常 #

报错显示系统在项目本地node_modules中查找npm，这不符合正常逻辑，需手动修正：

• 查看全局npm的正确路径：

  where npm
  

  正常应返回类似C:\Program Files\nodejs\npm.cmd的全局路径
• 手动删除项目内的node_modules/npm文件夹，再重新运行npm run dev

3. 重装Node.js（排查安装损坏） #

• 卸载当前Node.js，下载对应LTS版本（Laravel 9+推荐16.x-20.x）重新安装
• 重启终端，执行node -v和npm -v确认版本正常，再进入项目目录重新执行npm install和npm run dev

4. 检查package.json脚本配置 #

打开项目根目录的package.json，确认scripts字段为Laravel Vite标准配置：

"scripts": {
    "dev": "vite",
    "build": "vite build"
}

若配置异常，修改后再尝试运行命令

5. 以管理员身份运行终端 #

右键终端选择「以管理员身份运行」，进入项目目录后重新执行npm install和npm run dev，排查权限导致的依赖安装不完整问题

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