Laravel 8执行npm run dev遇“Error: Cannot find module”报错的解决办法

1. 强制清除npm缓存 #

缓存损坏可能导致依赖安装不完整，执行以下命令：

npm cache clean --force

2. 核对并补全开发依赖 #

Laravel 8依赖laravel-mix等核心包，检查package.json的devDependencies中是否包含相关包，若缺失，手动安装适配版本：

npm install laravel-mix@^6.0.6 @babel/core @babel/preset-env --save-dev

3. 切换兼容的Node版本 #

Laravel 8官方推荐Node版本为14.x-16.x，你当前使用的18.x可能存在兼容性问题。通过nvm切换版本：

# 若未安装nvm，先执行安装命令
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 安装并切换到Node 16.x
nvm install 16
nvm use 16

切换完成后重新执行npm install和npm run dev

4. 删除残留缓存文件 #

除了node_modules和package-lock.json，还需清理以下目录/文件：

rm -rf node_modules/.cache
rm -rf public/mix-manifest.json

之后重新安装依赖并启动开发服务

5. 检查核心配置文件 #

确认项目根目录存在webpack.mix.js，若缺失，创建基础配置文件：

const mix = require('laravel-mix');

mix.js('resources/js/app.js', 'public/js')
    .sass('resources/sass/app.scss', 'public/css');

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