安装gulp时出现命令未识别错误，运行gulp -v提示CommandNotFoundException

• 未全局安装gulp命令行工具：gulp的核心库和命令行工具是拆分的两个包，你只在项目本地安装了gulp核心库，没有全局安装gulp-cli，系统无法识别全局的gulp命令。
• 全局安装路径未加入环境变量：即便安装了gulp-cli，如果npm全局包的安装路径没有被添加到系统的PATH环境变量中，终端也无法找到gulp的执行入口。
• 全局安装失败：安装gulp-cli时因为权限不足、网络问题等原因导致安装未成功，实际系统中不存在对应的可执行文件。

方案1：使用项目本地gulp（推荐） #

无需全局安装工具，直接调用项目内安装的gulp即可：

• 临时执行命令时加npx前缀：运行npx gulp -v即可正常查看版本，执行其他gulp命令也只需在前面加npx 前缀即可。
• 配置npm脚本调用：在项目的package.json文件的scripts字段中添加对应命令，示例：

  {
    "scripts": {
      "gulp:version": "gulp -v",
      "build": "gulp build"
    }
  }
  

  之后运行npm run gulp:version即可调用本地gulp命令，该方式可以避免不同项目的gulp版本冲突问题。

方案2：全局安装gulp-cli #

如果需要直接使用gulp全局命令，安装官方拆分的命令行工具即可：

1. 先卸载可能存在的旧版全局gulp，避免冲突：npm uninstall --global gulp
2. 全局安装gulp-cli：
   • Windows系统：用管理员身份打开CMD/PowerShell，执行npm install --global gulp-cli
   • Mac/Linux系统：执行sudo npm install --global gulp-cli
3. 安装完成后重启终端，执行gulp -v即可正常返回版本信息。

方案3：检查修复环境变量 #

如果全局安装后仍报错，手动检查环境变量配置：

1. 执行npm config get prefix查看npm全局包的安装路径，复制输出的路径。
2. 打开系统环境变量设置，找到PATH变量，将刚才复制的路径添加进去，保存配置。
3. 重启终端后重新执行gulp -v即可。

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