Laravel 8执行npm run dev报Unknown option '--hide-modules'错误如何解决

解决步骤 #

• 首先排除无效操作：composer update是处理PHP后端依赖的命令，和本次前端构建报错无关，不需要执行。
• 第一步：检查package.json是否正确配置laravel-mix依赖，执行以下命令单独安装缺失依赖：
  npm install laravel-mix --save-dev
• 第二步：确认项目根目录存在webpack.mix.js配置文件，如果不存在手动创建，写入基础配置：

  const mix = require('laravel-mix');
  
  mix.js('resources/js/app.js', 'public/js')
      .sass('resources/sass/app.scss', 'public/css');
  

  如果你用的是Laravel 9+版本，框架默认改用Vite作为构建工具而非Laravel Mix，需要确认你是否迁移了老项目的Mix配置，若要使用Vite需要删除Mix相关依赖，改用Vite的对应配置和命令。
• 第三步：清理残留依赖文件重新安装：
  先删除项目根目录的node_modules文件夹、package-lock.json文件、yarn.lock（若存在），再依次执行：

  npm cache clean --force
  npm install
  npm run dev
  

• 第四步：排查权限和版本问题
  如果你使用Linux/Mac系统，不要使用sudo执行项目本地依赖安装命令，避免文件权限异常导致无法读取依赖。如果存在权限问题，先修改项目目录权限：
  sudo chown -R $USER:$USER ./
  另外可以将npm升级到最新稳定版后再重试：
  npm install -g npm@latest

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