使用 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,强烈建议你现在就开始使用它!

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


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

相关推荐
*小雪2 小时前
nvm的安装与管理和npm audit的报错解决
前端·npm·node.js
Marshmallowc2 小时前
React useState 数据不同步?深度解析无限滚动中的“闭包陷阱”与异步更新丢失问题
前端·javascript·react.js·闭包·fiber架构
某柚啊2 小时前
解决 minimatch 类型报错问题
前端·webpack·npm
前端 贾公子2 小时前
npm 发包配置双重身份验证
前端·javascript·微信小程序·小程序·github
xkxnq2 小时前
第四阶段:Vue 进阶与生态整合(第 48 天)(Vue 与 Axios 整合:实现 HTTP 请求的封装与拦截)
前端·vue.js·http
CappuccinoRose3 小时前
React框架学习文档(三)
前端·react.js·ui·数组·标签·属性·jsx
LBJ辉3 小时前
CSS - code
前端·css
旭日初扬3 小时前
N32H762IIL调试中遇到的错误
前端
辰风沐阳3 小时前
ES6 新特性: 解构赋值
前端·javascript·es6