首次运行Next.js应用遇编译错误及安装耗时问题求助

一、解决npx create-next-app@latest安装耗时久的问题 #

安装慢基本是网络镜像导致的，直接用国内镜像加速：

• 临时加速：执行 npx create-next-app@latest --registry=https://registry.npmmirror.com
• 永久配置：先运行 npm config set registry https://registry.npmmirror.com，之后再执行创建命令就会自动用国内源

二、编译错误的常见解决方法 #

虽然看不到你的错误截图，但新手首次运行遇到编译错误，按下面步骤排查：

1. 检查Node.js版本：Next.js 13及以上要求Node.js 16.8+，执行 node -v 查看版本，不够的话用nvm（Node版本管理器）升级，避免版本不兼容问题。
2. 重置依赖环境：
   • 删除项目根目录下的node_modules文件夹和package-lock.json文件
   • 重新执行 npm install 安装依赖
   • 再运行 npm run dev 试试
3. 检查默认文件是否被误改：创建项目时自动生成的pages/_app.js、pages/index.js等文件如果被不小心改坏，会直接导致编译失败。可以去Next.js官方仓库复制初始模板内容替换这些文件。
4. 更换端口运行：如果3000端口被其他程序占用，也会报错，执行 npm run dev -- -p 3001 指定其他端口启动。
5. 关于误输的num run dev：这个是无效命令，不会对项目造成任何影响，不用管它。

内容的提问来源于stack exchange，提问作者Ritick Lath