使用 Vite + React 19 集成 Tailwind CSS 与 shadcn/ui 组件库完整指南

使用 Vite + React 19 集成 Tailwind CSS 与 shadcn/ui 组件库完整指南

    • [🌟 前言](#🌟 前言)
    • [一、创建 React 19 项目](#一、创建 React 19 项目)
    • [二、集成 Tailwind CSS](#二、集成 Tailwind CSS)
      • [1️⃣ 安装依赖](#1️⃣ 安装依赖)
      • [2️⃣ 配置 Vite 插件](#2️⃣ 配置 Vite 插件)
      • [3️⃣ 引入 Tailwind](#3️⃣ 引入 Tailwind)
      • [4️⃣ 启动项目](#4️⃣ 启动项目)
    • 三、配置路径别名
      • [1️⃣ 修改 TypeScript 配置](#1️⃣ 修改 TypeScript 配置)
      • [2️⃣ 安装类型声明](#2️⃣ 安装类型声明)
      • [3️⃣ 配置 Vite 别名解析](#3️⃣ 配置 Vite 别名解析)
    • [四、集成 shadcn/ui 组件库](#四、集成 shadcn/ui 组件库)
      • [1️⃣ 初始化配置](#1️⃣ 初始化配置)
      • [2️⃣ 添加示例组件](#2️⃣ 添加示例组件)
    • 五、项目结构预览
    • [💡 常见问题](#💡 常见问题)
    • [🚀 最佳实践](#🚀 最佳实践)
    • 参考文档

🌟 前言

随着 React 19 的发布,开发者对高效开发工具链的需求日益增加。本文将手把手教你如何通过 Vite 快速搭建 React 19 项目,并整合 Tailwind CSSshadcn/ui 组件库,最后配置路径别名优化开发体验。


一、创建 React 19 项目

使用 pnpm 快速初始化项目:

bash 复制代码
pnpm create vite --template=react-ts

按提示输入项目名称后进入项目目录。


二、集成 Tailwind CSS

1️⃣ 安装依赖

bash 复制代码
npm install tailwindcss @tailwindcss/vite

2️⃣ 配置 Vite 插件

修改 vite.config.ts

typescript 复制代码
import { defineConfig } from 'vite'
import tailwindcss from '@tailwindcss/vite'

export default defineConfig({
  plugins: [tailwindcss()],
})

3️⃣ 引入 Tailwind

修改 index.css, 顶部添加:

css 复制代码
@import "tailwindcss";

4️⃣ 启动项目

bash 复制代码
npm run dev

三、配置路径别名

1️⃣ 修改 TypeScript 配置

tsconfig.json

json 复制代码
{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    }
  }
}

tsconfig.app.json

json 复制代码
{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    }
  }
}

2️⃣ 安装类型声明

bash 复制代码
pnpm add -D @types/node

3️⃣ 配置 Vite 别名解析

更新 vite.config.ts

typescript 复制代码
import path from "path"
import { defineConfig } from "vite"

export default defineConfig({
  resolve: {
    alias: {
      "@": path.resolve(__dirname, "./src"),
    },
  },
})

四、集成 shadcn/ui 组件库

1️⃣ 初始化配置

bash 复制代码
pnpm dlx shadcn@canary init

根据提示选择:

  • 使用 Tailwind CSS
  • 配置组件目录
  • 启用 dark mode

2️⃣ 添加示例组件

bash 复制代码
pnpm dlx shadcn@canary add sidebar-08

五、项目结构预览

复制代码
my-project/
├── src/
│   ├── components/  # shadcn 组件
│   ├── App.tsx
│   └── style.css
├── vite.config.ts
├── tailwind.config.js
└── tsconfig.json

💡 常见问题

  1. React 19 兼容性 :目前需使用 @canary 版本
  2. 样式不生效:检查 CSS 导入顺序
  3. 路径别名失效:重启 IDE 并验证配置

🚀 最佳实践

  • 使用 @/components 导入自定义组件
  • 定期更新 shadcn 组件库

参考文档

相关推荐
土豆12503 小时前
React Router 相对路径避坑指南:v5 到 v6 的颠覆性变革!
react.js
XXYBMOOO3 小时前
使用全局变量访问 Qt UI 组件的方法文档
c++·qt·ui
三月的一天4 小时前
React+threejs两种3D多场景渲染方案
前端·react.js·前端框架
十盒半价6 小时前
React 项目实战:从 0 到 1 构建高效 GitHub 仓库管理应用 —— 基于 React 全家桶的全栈开发指南
前端·react.js·trae
Bryce李小白6 小时前
Flutter 主流 UI 框架总结归纳
flutter·ui
FogLetter7 小时前
从零复刻网易云音乐年度总结H5:技术细节与用户体验的完美结合
前端·css
讨厌吃蛋黄酥7 小时前
React高手都在用的秘密武器:Fragment的5大逆天功能,让你的性能飙升200%!
前端·javascript·react.js
FliPPeDround8 小时前
@uni-helper 社区:让 uni-app 拥抱 ESM 时代
前端·uni-app·vite
薛定谔的算法8 小时前
为什么要有React?从“一万行灾难”到“十万行也很好”
前端·react.js·前端框架
伍哥的传说9 小时前
vite+vue3 工程-SVG图标配置使用指南——vite-plugin-svg-icons 插件
前端·vue.js·react.js·前端框架·vite-plugin-svg·vite 7·vite-plugin