1. 创建 React 项目

pnpm create vite@latest .

• 选择模板：React + TypeScript
• 安装依赖：

  pnpm install
  

---

2. 添加 Tailwind CSS

pnpm add -D tailwindcss postcss autoprefixer

• 修改 src/index.css 内容：

@import "tailwindcss";

---

3. 配置 TypeScript 路径别名

修改 tsconfig.json：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    }
  },
  "files": [],
  "references": [
    { "path": "./tsconfig.app.json" },
    { "path": "./tsconfig.node.json" }
  ]
}

修改 tsconfig.app.json：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    }
  },
  // ...其他配置
}

---

4. 配置 Vite 路径别名

1. 安装依赖：

   pnpm add -D @types/node
   

2. 修改 vite.config.ts：

    import path from "path"
    import tailwindcss from "@tailwindcss/vite"
    import react from "@vitejs/plugin-react"
    import { defineConfig } from "vite"
     
    // https://vite.dev/config/
    export default defineConfig({
      plugins: [react(), tailwindcss()],
      resolve: {
        alias: {
          "@": path.resolve(__dirname, "./src"),
        },
      },
    })
   

---

5. 初始化 shadcn/ui

pnpm dlx shadcn@latest init

• 按提示配置：
  

---

6. 添加并使用组件

1. 添加 Button 组件：

   pnpm dlx shadcn@latest add button
   

2. 在 src/App.tsx 中使用：

   import { Button } from "@/components/ui/button";
   
   function App() {
     return (
       <div className="flex min-h-screen items-center justify-center">
         <Button>click me </Button>
       </div>
     );
   }
   export default App;
   

---

7. 启动开发服务器

pnpm run dev

---

更多组件

安装命令（除 button 外）

pnpm dlx shadcn@latest add badge card input scroll-area select tabs textarea

完整使用示例

// 导入所有组件
import { Badge } from "@/components/ui/badge"
import { 
  Card, 
  CardHeader, 
  CardTitle, 
  CardDescription, 
  CardContent, 
  CardFooter 
} from "@/components/ui/card"
import { Input } from "@/components/ui/input"
import { ScrollArea } from "@/components/ui/scroll-area"
import { 
  Select, 
  SelectTrigger, 
  SelectValue, 
  SelectContent, 
  SelectItem 
} from "@/components/ui/select"
import { 
  Tabs, 
  TabsList, 
  TabsTrigger, 
  TabsContent 
} from "@/components/ui/tabs"
import { Textarea } from "@/components/ui/textarea"

function App() {
  return (
    <div className="max-w-3xl mx-auto p-6">
      {/* Badge */}
      <div className="mb-6 flex gap-2">
        <Badge>默认徽章</Badge>
        <Badge variant="secondary">次要徽章</Badge>
        <Badge variant="destructive">警告徽章</Badge>
      </div>

      {/* Card */}
      <Card className="mb-6">
        <CardHeader>
          <CardTitle>组件展示</CardTitle>
          <CardDescription>独立导入的 shadcn/ui 组件</CardDescription>
        </CardHeader>
        <CardContent>
          {/* Input & Textarea */}
          <div className="grid md:grid-cols-2 gap-4 mb-4">
            <div>
              <Input placeholder="单行文本输入..." />
            </div>
            <div>
              <Textarea placeholder="多行文本输入..." rows={3} />
            </div>
          </div>

          {/* Select */}
          <div className="mb-4">
            <Select>
              <SelectTrigger>
                <SelectValue placeholder="选择选项" />
              </SelectTrigger>
              <SelectContent>
                <SelectItem value="option1">选项一</SelectItem>
                <SelectItem value="option2">选项二</SelectItem>
                <SelectItem value="option3">选项三</SelectItem>
              </SelectContent>
            </Select>
          </div>

          {/* Tabs */}
          <Tabs defaultValue="account">
            <TabsList>
              <TabsTrigger value="account">账户</TabsTrigger>
              <TabsTrigger value="settings">设置</TabsTrigger>
              <TabsTrigger value="billing">账单</TabsTrigger>
            </TabsList>
            <TabsContent value="account" className="p-4 border rounded-b-lg">
              <p>账户管理内容区域</p>
            </TabsContent>
            <TabsContent value="settings" className="p-4 border rounded-b-lg">
              <p>系统设置内容区域</p>
            </TabsContent>
            <TabsContent value="billing" className="p-4 border rounded-b-lg">
              <p>账单信息内容区域</p>
            </TabsContent>
          </Tabs>
        </CardContent>
        <CardFooter className="flex justify-between">
          <Badge variant="outline">状态：激活</Badge>
          <span>卡片底部</span>
        </CardFooter>
      </Card>

      {/* Scroll Area */}
      <div className="h-64 border rounded-lg overflow-hidden">
        <ScrollArea className="h-full p-4 bg-gray-50">
          <div className="space-y-3">
            {[...Array(50)].map((_, i) => (
              <div key={i} className="flex items-center gap-3 p-2 border-b">
                <div className="bg-gray-200 border-2 border-dashed rounded-xl w-16 h-16" />
                <div>
                  <p className="font-medium">项目 {i + 1}</p>
                  <p className="text-sm text-gray-500">可滚动内容区域</p>
                </div>
              </div>
            ))}
          </div>
        </ScrollArea>
      </div>
    </div>
  )
}
export default App

启动

pnpm run dev

参考链接：https://ui.shadcn.com/docs/