执行gulp dev提示Local gulp not found的问题求助

哇，8小时卡在这里确实够闹心的！我之前踩过几乎一模一样的gulp坑，给你梳理几个能解决问题的步骤，按顺序试试：

第一步：彻底清理现有依赖，避免版本冲突 #

先把全局和本地的gulp相关包都清干净，防止旧版本搞事情：

• 卸载全局的gulp和gulp-cli：

  npm uninstall -g gulp gulp-cli
  

• 进入你的项目根目录，卸载本地的gulp依赖：

  npm uninstall gulp gulp-cli
  

• 删除项目里的node_modules文件夹和package-lock.json（如果用yarn就删yarn.lock）：
  • Mac/Linux：rm -rf node_modules package-lock.json
  • Windows：rmdir /s /q node_modules && del package-lock.json

第二步：按正确顺序重新安装 #

安装顺序很关键，先装全局cli，再装本地开发依赖：

• 全局安装gulp-cli（这是用来在命令行调用gulp的工具）：

  npm install -g gulp-cli
  

• 回到项目根目录，本地安装gulp作为开发依赖（必须加--save-dev，这样会写入package.json的devDependencies）：

  npm install --save-dev gulp
  

• 安装完后验证一下：运行npx gulp -v，如果能看到本地和全局的版本号，说明本地gulp已经正确安装了。

第三步：检查项目配置是否正确 #

• 确认项目根目录下有gulpfile.js（如果用ES6写的是gulpfile.babel.js），文件名绝对不能错，gulp默认只会识别这两个文件名。
• 检查package.json里的scripts配置，确保dev脚本是直接调用gulp dev，比如：

  "scripts": {
    "dev": "gulp dev"
  }
  

第四步：绕开npm link的问题 #

如果你之前用npm link gulp出现异常，大概率是全局和本地版本不匹配或者权限问题。可以直接用npx调用本地的gulp，比如：

npx gulp dev

npx会自动找项目node_modules里的gulp来运行，完全不用依赖全局链接。

第五步：权限问题排查（针对Mac/Linux用户） #

如果全局安装时提示权限错误，别用sudo！推荐用nvm管理node版本，或者给npm设置全局目录权限，避免权限冲突导致的安装异常。

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