使用 Vite 快速创建 React + TypeScript 项目全记录

🚀 使用 Vite 快速创建 React + TypeScript 项目全记录

从零开始,5分钟构建现代化 React 开发环境

📝 前言

今天我要记录一次使用 Vite 初始化 React 项目的完整过程。相比于传统的 Create React App (CRA),Vite 以其闪电般的启动速度和热更新能力,已经成为现代前端开发的首选工具。

🛠️ 准备工作

只需要确保你的电脑上安装了 Node.js(建议版本 18+)和 npm 即可。

🚀 开始创建项目

第一步:执行创建命令

在终端中运行以下命令:

bash 复制代码
npm create vite@latest

第二步:交互式配置过程

命令执行后,会出现一个清晰的交互式界面:

复制代码
│
◇  Project name:
│  react_demo01
│
◇  Select a framework:
│  React
│
◇  Select a variant:
│  TypeScript + SWC
│
◇  Use rolldown-vite (Experimental)?:
│  No
│
◇  Install with npm and start now?
│  Yes

让我来解释一下每一步的选择:

  1. 项目名称 :输入 react_demo01(可以根据需要修改)
  2. 选择框架 :选择 React
  3. 选择变体 :选择 TypeScript + SWC
    • SWC 是用 Rust 编写的高速打包工具,比 Babel 快很多
  4. 是否使用 rolldown-vite :选择 No
    • rolldown 是实验性的,生产环境建议先不启用
  5. 是否安装依赖并立即启动 :选择 Yes

第三步:项目创建过程

Vite 开始自动创建项目:

复制代码
◇  Scaffolding project in E:\WebstormProjects\react_study\demo01\react_demo01...
│
◇  Installing dependencies with npm...

added 172 packages in 18s

46 packages are looking for funding
  run `npm fund` for details

安装过程非常快速,仅用了 18 秒就完成了 172 个包的安装。

第四步:启动开发服务器

安装完成后,Vite 会自动启动开发服务器:

复制代码
◇  Starting dev server...

> react_demo01@0.0.0 dev
> vite


  VITE v7.3.1  ready in 1058 ms

  ➜  Local:   http://localhost:5173/
  ➜  Network: use --host to expose
  ➜  press h + enter to show help

注意这个启动速度!

Vite 只用了 1058 毫秒(约 1 秒)就启动了开发服务器!

📁 生成的项目结构

让我们看看 Vite 为我们生成了什么:

复制代码
react_demo01/
├── node_modules/
├── public/
│   └── vite.svg
├── src/
│   ├── assets/
│   │   └── react.svg
│   ├── App.css
│   ├── App.tsx
│   ├── index.css
│   ├── main.tsx
│   └── vite-env.d.ts
├── index.html
├── package.json
├── tsconfig.json
├── tsconfig.node.json
├── vite.config.ts
└── README.md

关键文件说明:

  1. vite.config.ts - Vite 配置文件
  2. src/main.tsx - React 应用的入口文件
  3. src/App.tsx - 主组件
  4. index.html - HTML 模板文件
  5. tsconfig.json - TypeScript 配置

🎯 访问项目

在浏览器中打开控制台显示的地址:

复制代码
http://localhost:5173/

你会看到 Vite + React 的欢迎页面,包含一个旋转的 React 图标和计数器示例。

🔧 常用命令

现在你的项目已经可以运行了,以下是一些常用命令:

bash 复制代码
# 启动开发服务器
npm run dev

# 构建生产版本
npm run build

# 预览构建结果
npm run preview

# 运行类型检查
npm run type-check

💡 为什么选择 Vite?

闪电般的启动速度

传统工具(如 Webpack)需要打包整个应用才能启动,而 Vite 利用了现代浏览器的 ES 模块支持,实现了按需编译

极快的热更新

无论应用大小,热更新都能在毫秒级别完成。

开箱即用的功能

  • TypeScript 支持
  • JSX 支持
  • CSS 预处理器
  • 环境变量
  • 资源处理

易于配置

配置文件简单明了,易于理解和修改。

🚀 下一步行动

项目已经创建完成,你可以开始:

  1. 修改 src/App.tsx 开始编写你的 React 组件
  2. 添加路由 :安装 react-router-dom
  3. 状态管理:根据需要选择 Redux、Zustand 等
  4. 样式方案:可以继续使用 CSS,或切换到 Tailwind CSS、Styled Components 等

📊 性能对比

特性 Vite Create React App
启动时间 ~1秒 ~30秒+
热更新 毫秒级 秒级
构建速度
配置复杂度 简单 复杂
生态支持 良好 优秀

🎉 总结

通过这次实践,我们可以看到使用 Vite 创建 React + TypeScript 项目是多么简单快捷。整个过程不到 2 分钟,就获得了一个现代化的、高性能的开发环境。

Vite 不仅提升了开发体验,更重要的是它改变了我们对前端工具链速度的认知。如果你还没有尝试过 Vite,强烈建议你现在就开始使用它!

告别漫长的等待,拥抱闪电般的开发体验!


希望这篇记录对你有帮助。如果你在创建过程中遇到任何问题,欢迎在评论区留言讨论!

相关推荐
powerfulhell5 分钟前
寒假python作业5
java·前端·python
木子啊20 分钟前
前端组件化:模板继承拯救发际线
前端
三十_A23 分钟前
零基础通过 Vue 3 实现前端视频录制 —— 从原理到实战
前端·vue.js·音视频
前端小菜袅23 分钟前
PC端原样显示移动端页面方案
开发语言·前端·javascript·postcss·px-to-viewport·移动端适配pc端
We་ct24 分钟前
LeetCode 228. 汇总区间:解题思路+代码详解
前端·算法·leetcode·typescript
爱问问题的小李40 分钟前
ue 动态 Key 导致组件无限重置与 API 重复提交
前端·javascript·vue.js
早點睡3901 小时前
高级进阶 ReactNative for Harmony项目鸿蒙化三方库集成实战:react-native-image-picker(打开手机相册)
react native·react.js·harmonyos
早點睡3901 小时前
基础入门 React Native 鸿蒙跨平台开发:react-native-easy-toast三方库适配
react native·react.js·harmonyos
子兮曰1 小时前
深入Vue 3响应式系统:为什么嵌套对象修改后界面不更新?
前端·javascript·vue.js
CHU7290351 小时前
直播商城APP前端功能全景解析:打造沉浸式互动购物新体验
java·前端·小程序