React / 系统课时
使用 Vite 创建 React 项目
使用 Vite 创建 React 项目
本课将从零创建一个 React 18 与 TypeScript 项目,并完成启动、目录识别和生产构建验证。完成后,你会得到一个可继续开发的最小工程,同时知道代码从哪个文件进入浏览器。
学习目标
- 使用 Vite 的 React TypeScript 模板创建项目
- 认识
main.tsx、App.tsx、public和src的职责 - 启动开发服务器并验证生产构建
前置检查
先确认本机已经安装 Node.js 和 npm。建议使用仍受维护的 Node.js LTS 版本,避免模板工具因运行时过旧而失败。
node --version
npm --version预期输出
v<VERSION>
<VERSION><VERSION> 代表本机实际版本。若命令不存在,应先安装 Node.js,再重新打开终端验证环境变量。
创建并启动项目
下面的命令创建名为 react-vite-demo 的项目,并选择 React 与 TypeScript 模板。随后把 React、React DOM 及类型声明锁定在 18 主版本,避免模板的默认版本偏离本课程。-- 后面的参数会传给 Vite 创建器。
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预期输出
VITE v<VERSION> ready in <TIME>
Local: http://localhost:<PORT>/终端中的版本、耗时和端口会随环境变化。浏览器打开终端给出的本地地址后,应看到 Vite 提供的 React 初始页面;修改页面文字并保存时,开发服务器会自动刷新模块。
认识入口与目录
创建后的核心结构如下。public 保存不经过模块导入的静态资源,src 保存参与编译的应用代码,根目录配置文件负责构建、类型检查和依赖管理。
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 错误、无效导入和打包问题。
npm run build预期输出
✓ built in <TIME>构建成功后会生成 dist 目录。若出现找不到模块,先检查文件名大小写和相对路径;若端口被占用,可使用终端提示的新端口,或运行 npm run dev -- --port <PORT> 指定其他端口。