React / 系统课时

使用 Vite 创建 React 项目

使用 Vite 创建 React 项目

本课将从零创建一个 React 18 与 TypeScript 项目,并完成启动、目录识别和生产构建验证。完成后,你会得到一个可继续开发的最小工程,同时知道代码从哪个文件进入浏览器。

学习目标

  • 使用 Vite 的 React TypeScript 模板创建项目
  • 认识 main.tsx、App.tsx、public 和 src 的职责
  • 启动开发服务器并验证生产构建

前置检查

先确认本机已经安装 Node.js 和 npm。建议使用仍受维护的 Node.js LTS 版本,避免模板工具因运行时过旧而失败。

bash
node --version
npm --version

预期输出

text
v<VERSION>
<VERSION>

<VERSION> 代表本机实际版本。若命令不存在,应先安装 Node.js,再重新打开终端验证环境变量。

创建并启动项目

下面的命令创建名为 react-vite-demo 的项目,并选择 React 与 TypeScript 模板。随后把 React、React DOM 及类型声明锁定在 18 主版本,避免模板的默认版本偏离本课程。-- 后面的参数会传给 Vite 创建器。

bash
npm create vite@latest react-vite-demo -- --template react-ts
cd react-vite-demo
npm install
npm install react@18 react-dom@18
npm install -D @types/react@18 @types/react-dom@18
npm run dev

预期输出

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

终端中的版本、耗时和端口会随环境变化。浏览器打开终端给出的本地地址后,应看到 Vite 提供的 React 初始页面;修改页面文字并保存时,开发服务器会自动刷新模块。

认识入口与目录

创建后的核心结构如下。public 保存不经过模块导入的静态资源,src 保存参与编译的应用代码,根目录配置文件负责构建、类型检查和依赖管理。

text
react-vite-demo/
├─ public/
├─ src/
│  ├─ assets/
│  ├─ App.tsx
│  ├─ main.tsx
│  └─ index.css
├─ index.html
├─ package.json
├─ tsconfig.json
└─ vite.config.ts

浏览器先加载根目录的 index.html,其中的脚本再执行 src/main.tsx。main.tsx 创建 React 根节点并渲染 App,因此它是应用启动入口;业务页面通常从 App.tsx 或路由配置继续展开。

构建验证与常见问题

开发服务器正常并不代表生产构建一定通过。提交代码前执行构建,可以提前发现 TypeScript 错误、无效导入和打包问题。

bash
npm run build

预期输出

text
✓ built in <TIME>

构建成功后会生成 dist 目录。若出现找不到模块,先检查文件名大小写和相对路径;若端口被占用,可使用终端提示的新端口,或运行 npm run dev -- --port <PORT> 指定其他端口。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Vite 创建 React 项目

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

登录哪都通