执行npm start启动gulp时报'node_modules'不是内部或外部命令怎么解决

报错详情 #

> start
node_modules/.bin/gulp watch
'node_modules' is not recognized as an internal or external command, operable program or batch file.

报错根因 #

该问题通常出现在Windows系统环境中，核心原因有两个：

• 脚本路径使用了Linux/macOS专属的正斜杠/写法，Windows系统无法识别该路径格式
• 冗余配置了node_modules/.bin路径，npm执行scripts字段下的命令时，会自动将该目录加入临时执行环境路径，无需手动指定

解决方案 #

最优方案（全平台兼容） #

直接简化package.json中的scripts配置：

1. 打开项目根目录下的package.json文件
2. 将scripts字段修改为如下内容：

"scripts": {
  "start": "gulp watch"
}

3. 保存文件后重新执行npm start即可正常运行

特殊场景适配方案（仅Windows可用） #

如果你有特殊需求必须指定完整路径，将路径中的正斜杠替换为Windows兼容的双反斜杠即可：

"scripts": {
  "start": "node_modules\\.bin\\gulp watch"
}

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