React / 系统课时

运行与构建项目

运行与构建项目

本课梳理 Vite React 项目的三类核心命令:开发运行、生产构建和构建预览。完成后,你能正确选择命令、识别输出目录,并通过本地检查确认项目具备交付条件。

学习目标

  • 区分开发服务器、生产构建和本地预览
  • 读懂 package.json 中的脚本入口
  • 验证构建结果并处理常见失败

先认识项目脚本

Vite React TypeScript 模板的 package.json 通常包含以下脚本。具体内容以当前项目为准:

json
{
  "scripts": {
    "dev": "vite",
    "build": "tsc -b && vite build",
    "lint": "eslint .",
    "preview": "vite preview"
  }
}

生效行为:npm run <名称> 会执行对应字符串。build 先进行 TypeScript 项目检查,再由 Vite 生成生产文件;任一步失败,构建都会停止。

启动开发服务器

开发阶段执行:

bash
npm run dev

预期输出包含本地地址,实际耗时和端口可能不同:

text
VITE ready in <TIME> ms
Local: http://localhost:<PORT>/

开发服务器面向本地编码体验,支持模块热更新和友好错误提示。它不会生成最终部署目录,也不应直接作为生产服务器长期对外提供服务。

修改 src/App.tsx 后保存,页面应快速更新。若浏览器没有变化,先确认终端命令仍在运行,再检查文件是否保存、访问端口是否与终端一致。

执行生产构建

准备交付前执行:

bash
npm run build

预期结果是类型检查和构建均成功,并在项目根目录生成 dist。文件名通常带哈希,实际大小与耗时会不同:

text
dist/index.html
dist/assets/index-<HASH>.js
dist/assets/index-<HASH>.css
built in <TIME>

dist 中是浏览器需要的静态文件。哈希文件名有利于缓存更新,不要在代码或部署脚本中写死具体哈希。构建前出现 TypeScript 错误时,应修复源码,而不是跳过类型检查掩盖问题。

预览构建产物

构建成功后运行:

bash
npm run preview

预期输出:

text
Local: http://localhost:<PORT>/

打开该地址,检查首页、静态资源和主要交互。预览服务读取的是 dist,适合在部署前发现资源路径或构建模式问题,但它仍是本地验证工具,不等同于完整生产部署方案。

一次完整验收

建议按固定顺序执行检查,避免只看开发服务器正常就直接交付:

bash
npm run lint
npm run build
npm run preview

预期结果:Lint 没有阻断错误,构建生成 dist,预览地址能够打开并显示与预期一致的页面。preview 会持续占用终端,检查完成后可按 Ctrl+C 停止。

常见失败定位

开发命令提示端口占用时,以 Vite 选择的新端口为准,或先停止占用进程。页面能开发运行但构建失败,通常是 TypeScript 检查发现了开发过程中未阻断的问题,应从第一条错误开始修复。

预览时资源返回 404,需检查部署基础路径、资源引用方式和 vite.config.ts 的 base 配置。不要手动修改 dist 修复问题,因为下一次构建会覆盖这些改动;应修改源码或构建配置后重新生成。

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

目录与阅读设置

阅读设置

17

记录一个想法

运行与构建项目

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

登录哪都通