电脑安装Next.js后执行npm run dev无响应，按文档操作仍遇问题求帮助
2026-7-23
排查Next.js
npm run dev无响应问题 - 核对Node.js与npm版本兼容性：Next.js对Node版本有明确要求（如最新稳定版需Node 18.17+），执行
node -v和npm -v确认版本符合官方文档标准，版本不匹配常导致静默启动失败。 - 清理缓存重装依赖：
- 删除
node_modules文件夹：Mac/Linux用rm -rf node_modules，Windows用rmdir /s/q node_modules - 删除
package-lock.json文件 - 重新执行
npm install，全程留意安装日志是否有报错
- 删除
- 检查端口占用：Next.js默认用3000端口，Mac/Linux执行
lsof -i :3000，Windows执行netstat -ano | findstr :3000，若端口被占用，杀死对应进程或修改启动端口（把package.json里的dev命令改成next dev -p 3001） - 确认脚本配置：检查
package.json的scripts字段，确保dev是"dev": "next dev"，无拼写错误或多余参数 - 强制输出调试信息：把
package.json的dev命令改为"dev": "next dev --debug"，换不同终端（如PowerShell、bash）执行，查看是否有隐藏错误输出 - 测试极简项目：用
npx create-next-app@latest test-app新建一个空白项目，进入后执行npm run dev，如果能正常启动，说明原项目的next.config.js、.env等配置文件可能存在问题，可逐步对比排查
附用户提供的终端截图：
内容的提问来源于stack exchange，提问作者Saiful Alam
相关产品推荐
相关产品推荐
