React / 系统课时
运行与构建项目
运行与构建项目
本课完成 Next.js 项目从开发运行到生产构建的完整验证。你将掌握三个核心命令,理解它们使用的产物不同,并能根据终端与浏览器结果判断项目是否可交付。
学习目标
- 启动开发服务器并访问页面
- 生成生产构建并读取结果
- 使用本地生产模式验证构建产物
启动开发模式
进入项目目录后运行:
npm run dev预期输出:
Local: http://localhost:<PORT>
Ready in <TIME>默认端口通常是 3000,但端口被占用时实际值可能不同。打开终端显示的地址,应看到脚手架生成的首页。
开发模式会监听源文件变化。保存 app/page.tsx 后,浏览器通常会自动或快速更新,适合日常编码,但它不代表生产构建一定成功。
执行生产构建
先在运行开发服务器的终端按 Ctrl+C 停止进程,再执行:
npm run build预期结果:
编译与类型检查通过,并生成可用于生产启动的构建产物。构建过程会检查模块解析、TypeScript 类型和路由生成。若这里失败,即使开发页面曾经可以打开,也不能视为可部署。
启动本地生产模式
生产启动命令依赖已经生成的构建产物,因此必须先成功执行 npm run build。
npm run start预期输出:
Local: http://localhost:<PORT>
Ready in <TIME>再次打开终端显示的地址,确认页面与资源加载正常。此时运行的是优化后的生产产物,不再提供开发模式的热更新体验。
三个命令的区别
npm run dev 面向开发,强调快速反馈和错误提示。npm run build 只生成并检查生产产物,不负责长期提供网页服务。npm run start 读取已有构建产物并启动生产服务器。
因此,正确验收顺序是先开发验证,再生产构建,最后本地生产启动。只执行其中一条命令无法覆盖完整流程。
常见失败处理
端口被占用时,可以结束占用进程,也可以指定新端口:
npm run dev -- --port 3001预期输出:
Local: http://localhost:3001
Ready in <TIME>如果 npm run start 提示找不到生产构建,先执行 npm run build。如果构建出现类型错误,应修复源代码,不要通过关闭类型检查来掩盖问题。
若浏览器无法访问但终端显示已就绪,先确认访问的是终端给出的实际端口,再检查本机代理、防火墙和进程是否仍在运行。
验收清单
开发模式下修改文字后页面应更新;生产构建应无错误退出;生产启动后首页应能访问;终止进程后端口应释放。完成这四项,说明项目的本地运行链路已经打通。