执行npm run dev时出现MODULE_NOT_FOUND错误求助（Next.js/React）

架构老林

2026-7-4

解决npm run dev时的MODULE_NOT_FOUND错误（Next.js项目）

问题背景

Node.js版本：v20.6.1，npm版本：10.2.5
项目路径：PS C:\Users\DELL\Desktop\Ultimate Ecommerce Development with React & Next.js\udemy\nextecom
执行npm run dev后报错：

nextecom@0.1.0 dev
next dev

'Next.js\udemy\nextecom\node_modules\.bin\' is not recognized as an internal or external command,
operable program or batch file.
node:internal/modules/cjs/loader:1051
  throw err;
  ^

Error: Cannot find module 'C:\Users\DELL\Desktop\next\dist\bin\next'
    at Module._resolveFilename (node:internal/modules/cjs/loader:1048:15)
    at Module._load (node:internal/modules/cjs/loader:901:27)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:83:12)
    at node:internal/main/run_main_module:23:47 {
  code: 'MODULE_NOT_FOUND',
  requireStack: []
}

Node.js v20.6.1

解决步骤

清理并重装依赖
删除项目目录下的node_modules文件夹和package-lock.json文件，然后执行：
```
npm install
```
依赖安装不完整或缓存冲突是这类问题的常见诱因，重装能修复多数路径解析异常。
处理路径中的空格
你的项目路径包含空格（Ultimate Ecommerce Development with React & Next.js），Windows环境下npm对带空格的路径处理容易出错：
- 最简方案：把项目文件夹移动到无空格的路径下，比如C:\Users\DELL\Desktop\nextecom
- 临时修复：修改package.json中的dev脚本，用引号包裹命令：
```
"scripts": {
  "dev": "\"node_modules/.bin/next\" dev"
}
```
直接调用本地Next.js命令
跳过npm script的路径解析环节，直接执行：
```
npx next dev
```
或者直接指向本地安装的Next.js二进制文件：
```
node node_modules/next/dist/bin/next dev
```
确认Next.js依赖存在
检查package.json的dependencies字段是否包含next，如果没有，手动安装：
```
npm install next
```