Laravel+React项目执行npm install遇gulp-util废弃警告如何解决？

架构老林

2026-5-26

Fixing npm Install Issues When Setting Up Laravel + React Project

Hey there, let's tackle your problem step by step—we'll address both the deprecated gulp-util warning and the stalled npm install process.

1. Resolving the `gulp-util` Deprecation Warning

This warning pops up because some of your Laravel project's dependencies (most likely Laravel Mix if you're using older versions) still rely on the deprecated gulp-util package. Here's how to fix it:

Upgrade Laravel Mix to the latest version: Laravel Mix has long since moved away from gulp-util. Run this command to update it:
```
npm install laravel-mix@latest --save-dev
```
If you're using an older Laravel version: If you can't upgrade the entire framework, check your package.json for direct references to gulp-util and remove them. Replace it with modern alternatives like gulp-cli or utility packages from the vinyl ecosystem (though upgrading Laravel Mix is usually the simplest fix).
Switch to Vite (for Laravel 8+): Laravel 8 and above default to Vite instead of Laravel Mix. If you're starting fresh, scaffold your React project with Vite using:
```
php artisan ui react --vite
```
This sets up a modern frontend stack without any deprecated gulp dependencies.

2. Fixing the Stalled npm Install Process

A stalled npm install is usually caused by network issues, corrupted cache, or dependency conflicts. Try these solutions in order:

Clear npm's cache: Corrupted cache can cause installation hangs. Run:
```
npm cache clean --force
```
Delete existing dependencies and lock files: Conflicts in node_modules or package-lock.json can stall the process. Remove them and start fresh:
```
rm -rf node_modules package-lock.json
npm install
```
Use a faster registry: If downloads are too slow, switch to a regional registry to speed things up:
```
npm install --registry=https://registry.npmmirror.com
```
Try Yarn instead: Yarn often handles dependency resolution more smoothly than npm. Install Yarn first, then run:
```
npm install -g yarn
yarn install
```