React / 系统课时

运行与构建项目

运行与构建项目

本课完成 Next.js 项目从开发运行到生产构建的完整验证。你将掌握三个核心命令,理解它们使用的产物不同,并能根据终端与浏览器结果判断项目是否可交付。

学习目标

  • 启动开发服务器并访问页面
  • 生成生产构建并读取结果
  • 使用本地生产模式验证构建产物

启动开发模式

进入项目目录后运行:

bash
npm run dev

预期输出:

text
Local: http://localhost:<PORT>
Ready in <TIME>

默认端口通常是 3000,但端口被占用时实际值可能不同。打开终端显示的地址,应看到脚手架生成的首页。

开发模式会监听源文件变化。保存 app/page.tsx 后,浏览器通常会自动或快速更新,适合日常编码,但它不代表生产构建一定成功。

执行生产构建

先在运行开发服务器的终端按 Ctrl+C 停止进程,再执行:

bash
npm run build

预期结果:

text
编译与类型检查通过,并生成可用于生产启动的构建产物。

构建过程会检查模块解析、TypeScript 类型和路由生成。若这里失败,即使开发页面曾经可以打开,也不能视为可部署。

启动本地生产模式

生产启动命令依赖已经生成的构建产物,因此必须先成功执行 npm run build。

bash
npm run start

预期输出:

text
Local: http://localhost:<PORT>
Ready in <TIME>

再次打开终端显示的地址,确认页面与资源加载正常。此时运行的是优化后的生产产物,不再提供开发模式的热更新体验。

三个命令的区别

npm run dev 面向开发,强调快速反馈和错误提示。npm run build 只生成并检查生产产物,不负责长期提供网页服务。npm run start 读取已有构建产物并启动生产服务器。

因此,正确验收顺序是先开发验证,再生产构建,最后本地生产启动。只执行其中一条命令无法覆盖完整流程。

常见失败处理

端口被占用时,可以结束占用进程,也可以指定新端口:

bash
npm run dev -- --port 3001

预期输出:

text
Local: http://localhost:3001
Ready in <TIME>

如果 npm run start 提示找不到生产构建,先执行 npm run build。如果构建出现类型错误,应修复源代码,不要通过关闭类型检查来掩盖问题。

若浏览器无法访问但终端显示已就绪,先确认访问的是终端给出的实际端口,再检查本机代理、防火墙和进程是否仍在运行。

验收清单

开发模式下修改文字后页面应更新;生产构建应无错误退出;生产启动后首页应能访问;终止进程后端口应释放。完成这四项,说明项目的本地运行链路已经打通。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

运行与构建项目

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通