Laravel项目执行npm install遇gulp-util弃用警告，如何解决？

嘿，这个问题我之前也碰到过！别慌，这个gulp-util的废弃警告其实大多时候只是npm的提醒，不一定真的会阻断安装——先别急着卡在这里，先检查下你的node_modules目录是不是已经生成了，或者直接试试跑npm run dev看能不能正常编译资源。如果能正常用，其实完全可以忽略这个警告继续开发；但如果你就是想把这个警告彻底解决掉，试试下面这几个方法：

方法1：升级Laravel Mix版本 #

这个警告的根源是旧版Laravel Mix依赖了已废弃的gulp-util包，升级Mix到最新版就能解决：

• 先卸载旧的Mix依赖：npm uninstall laravel-mix
• 安装最新稳定版：npm install laravel-mix@latest --save-dev
• 重新运行npm install

方法2：强制替换废弃的gulp-util包 #

如果升级Mix后还是有问题，或者你的项目依赖了其他旧包导致gulp-util残留，可以用npm-force-resolutions强制替换：

• 先安装工具包：npm install npm-force-resolutions --save-dev
• 在你的package.json里添加resolutions字段，指定替换的版本：

  "resolutions": {
    "gulp-util": "^4.0.0"
  }
  

• 接着修改package.json的scripts，添加一个预安装脚本：

  "scripts": {
    "preinstall": "npx npm-force-resolutions"
  }
  

• 最后重新执行npm install

方法3：清理npm缓存后重试 #

有时候缓存会导致依赖解析异常，试试清理缓存后重新安装：

• 强制清理npm缓存：npm cache clean --force
• 删除本地依赖目录和锁文件：
  • macOS/Linux：rm -rf node_modules package-lock.json
  • Windows：rmdir /s /q node_modules && del package-lock.json
• 重新运行npm install

额外提示 #

如果你的Laravel版本比较旧（比如5.x系列），官方的Vue preset搭配的Mix版本确实依赖旧的gulp-util，这种情况下如果升级Mix可能会出现兼容性问题。这时候要么接受这个警告（它不会影响实际功能），要么考虑逐步升级你的Laravel项目到较新的版本（比如8.x及以上），新版本的Mix已经完全移除了对gulp-util的依赖。

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