如何解决npx gulp命令启动失败的MODULE_NOT_FOUND错误？

问题描述 #

在Gulp项目所在文件夹执行npm init时出现错误，随后运行npx gulp触发如下报错：

PS D:\Документы\Знания\IT\Fullstack Python\Веб верстка. Продвинутый курс\ДЗ\weblayout-advanced\06_bundlers> npx gulp
node:internal/modules/cjs/loader:1080
throw err;
^

Error: Cannot find module 'D:\Документы\Знания\IT\Fullstack Python\Веб
верстка. Продвинутый
курс\ДЗ\weblayout-advanced\06_bundlers\node_modules\gulp\b in\gulp.js'
at Module._resolveFilename (node:internal/modules/cjs/loader:1077:15)
at Module._load (node:internal/modules/cjs/loader:922:27)
at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:81:12)
at node:internal/main/run_main_module:23:47 {   code: 'MODULE_NOT_FOUND',   requireStack: [] }

Node.js v18.17.1

解决方案 #

• 清理残留文件，重新初始化并安装依赖

  1. 删除项目根目录下的node_modules文件夹、package-lock.json文件
  2. 执行npm init -y快速生成标准的package.json文件（跳过交互式提问，规避之前的init错误）
  3. 安装本地Gulp依赖：npm install gulp --save-dev

• 解决路径解析异常问题
  从报错信息能看到路径被强制换行，大概率是路径包含空格、非英文字符导致Node.js解析模块路径失败：

  • 将整个项目文件夹移动到不含特殊字符的路径下，比如D:\projects\weblayout-advanced\06_bundlers
  • 切换到新路径后重新执行npx gulp

• 排查全局版本冲突
  如果之前全局安装过Gulp，可能和本地依赖版本冲突：

  • 执行npm uninstall -g gulp移除全局Gulp
  • 仅保留项目本地的Gulp依赖，再次运行npx gulp

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