Next.js执行npm run dev时出现Project directory could not be found错误求助

数据老陈

2026-7-27

解决Next.js "Project directory could not be found" 错误

原因排查及修复步骤

确认运行命令的目录
执行npm run dev时，必须处于Next.js项目的根目录下。错误提示说明Next.js找不到项目核心配置文件，先检查自己当前的终端路径是否正确。
验证项目核心文件完整性
替换public和source文件夹后，确保项目根目录下的关键文件没有丢失：
- package.json
- next.config.js
- 若node_modules被误删，重新执行npm install恢复依赖
清理Next.js缓存
文件替换后缓存可能冲突，执行以下命令清理后重启服务：
```
rm -rf .next
npm run dev
```
Windows系统使用：
```
rmdir /s .next
npm run dev
```
检查.env文件格式
确保.env文件语法正确，客户端环境变量需以NEXT_PUBLIC_开头，示例：
```
NEXT_PUBLIC_GOOGLE_CLIENT_ID=你的令牌内容
```
重启终端
终端的工作目录缓存可能异常，关闭当前终端窗口，重新打开后进入项目根目录再执行npm run dev。