React / 系统课时
运行与构建项目
运行与构建项目
本课梳理 Vite React 项目的三类核心命令:开发运行、生产构建和构建预览。完成后,你能正确选择命令、识别输出目录,并通过本地检查确认项目具备交付条件。
学习目标
- 区分开发服务器、生产构建和本地预览
- 读懂
package.json中的脚本入口 - 验证构建结果并处理常见失败
先认识项目脚本
Vite React TypeScript 模板的 package.json 通常包含以下脚本。具体内容以当前项目为准:
{
"scripts": {
"dev": "vite",
"build": "tsc -b && vite build",
"lint": "eslint .",
"preview": "vite preview"
}
}生效行为:npm run <名称> 会执行对应字符串。build 先进行 TypeScript 项目检查,再由 Vite 生成生产文件;任一步失败,构建都会停止。
启动开发服务器
开发阶段执行:
npm run dev预期输出包含本地地址,实际耗时和端口可能不同:
VITE ready in <TIME> ms
Local: http://localhost:<PORT>/开发服务器面向本地编码体验,支持模块热更新和友好错误提示。它不会生成最终部署目录,也不应直接作为生产服务器长期对外提供服务。
修改 src/App.tsx 后保存,页面应快速更新。若浏览器没有变化,先确认终端命令仍在运行,再检查文件是否保存、访问端口是否与终端一致。
执行生产构建
准备交付前执行:
npm run build预期结果是类型检查和构建均成功,并在项目根目录生成 dist。文件名通常带哈希,实际大小与耗时会不同:
dist/index.html
dist/assets/index-<HASH>.js
dist/assets/index-<HASH>.css
built in <TIME>dist 中是浏览器需要的静态文件。哈希文件名有利于缓存更新,不要在代码或部署脚本中写死具体哈希。构建前出现 TypeScript 错误时,应修复源码,而不是跳过类型检查掩盖问题。
预览构建产物
构建成功后运行:
npm run preview预期输出:
Local: http://localhost:<PORT>/打开该地址,检查首页、静态资源和主要交互。预览服务读取的是 dist,适合在部署前发现资源路径或构建模式问题,但它仍是本地验证工具,不等同于完整生产部署方案。
一次完整验收
建议按固定顺序执行检查,避免只看开发服务器正常就直接交付:
npm run lint
npm run build
npm run preview预期结果:Lint 没有阻断错误,构建生成 dist,预览地址能够打开并显示与预期一致的页面。preview 会持续占用终端,检查完成后可按 Ctrl+C 停止。
常见失败定位
开发命令提示端口占用时,以 Vite 选择的新端口为准,或先停止占用进程。页面能开发运行但构建失败,通常是 TypeScript 检查发现了开发过程中未阻断的问题,应从第一条错误开始修复。
预览时资源返回 404,需检查部署基础路径、资源引用方式和 vite.config.ts 的 base 配置。不要手动修改 dist 修复问题,因为下一次构建会覆盖这些改动;应修改源码或构建配置后重新生成。