shadcn/ui 是 2023 年前端圈最火的 UI 解决方案之一，但它不是传统意义上的"组件库"。

shadcn/ui 是什么

# 安装（不是 npm install，是复制代码到你的项目）
npx shadcn-ui@latest add button
# 这个命令会把 Button 组件的源代码复制到 src/components/ui/button.tsx

传统组件库（Element UI、Ant Design）：你安装它，用它，但不能改它（只能用 API 覆盖）。

shadcn/ui：把组件代码放到你的项目里，你就拥有了这段代码，可以随意修改。

技术栈

npm install @radix-ui/react-dialog class-variance-authority tailwind-merge

• Radix UI：无样式、可访问性强的组件原语
• Tailwind CSS：样式
• class-variance-authority (CVA)：管理变体

组件结构

// components/ui/button.tsx（shadcn/ui 生成的）
import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { cn } from "@/lib/utils"

const buttonVariants = cva(
  // 基础样式
  "inline-flex items-center justify-center rounded-md text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 disabled:opacity-50",
  {
    variants: {
      variant: {
        default: "bg-primary text-primary-foreground hover:bg-primary/90",
        destructive: "bg-destructive text-destructive-foreground hover:bg-destructive/90",
        outline: "border border-input hover:bg-accent",
        ghost: "hover:bg-accent hover:text-accent-foreground",
        link: "text-primary underline-offset-4 hover:underline",
      },
      size: {
        default: "h-10 px-4 py-2",
        sm: "h-9 rounded-md px-3",
        lg: "h-11 rounded-md px-8",
      },
    },
    defaultVariants: {
      variant: "default",
      size: "default",
    },
  }
)

export interface ButtonProps
  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
    VariantProps<typeof buttonVariants> {}

const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
  ({ className, variant, size, ...props }, ref) => {
    return (
      <button
        className={cn(buttonVariants({ variant, size, className }))}
        ref={ref}
        {...props}
      />
    )
  }
)

export { Button, buttonVariants }

使用方式

import { Button } from "@/components/ui/button";
import {
  Dialog,
  DialogContent,
  DialogHeader,
  DialogTitle,
} from "@/components/ui/dialog";
import { Input } from "@/components/ui/input";

function CreateUserDialog() {
  const [open, setOpen] = useState(false);

  return (
    <>
      <Button onClick={() => setOpen(true)}>创建用户</Button>

      <Dialog open={open} onOpenChange={setOpen}>
        <DialogContent>
          <DialogHeader>
            <DialogTitle>创建新用户</DialogTitle>
          </DialogHeader>

          <div className="space-y-4">
            <Input placeholder="用户名" />
            <Input type="email" placeholder="邮箱" />
            <div className="flex gap-2 justify-end">
              <Button variant="outline" onClick={() => setOpen(false)}>
                取消
              </Button>
              <Button>确认</Button>
            </div>
          </div>
        </DialogContent>
      </Dialog>
    </>
  );
}

为什么这个思路好

1. 可访问性：基于 Radix UI，键盘导航、ARIA 属性都处理好了
2. 可定制：代码在你项目里，改样式、改行为、加功能都随意
3. 无版本锁定：不依赖上游的版本升级，你就是维护者
4. 按需复制：只复制你需要的组件，没有无用代码

缺点：不是"安装就用"，需要理解 Tailwind + Radix 才能定制。

cn 工具函数

// lib/utils.ts
import { clsx, type ClassValue } from "clsx";
import { twMerge } from "tailwind-merge";

// 合并 className，解决 Tailwind 类名冲突
export function cn(...inputs: ClassValue[]) {
  return twMerge(clsx(inputs));
}

// 使用
cn("px-4 py-2", "px-8"); // → "py-2 px-8"（不会重复 px）

小结

• shadcn/ui 不是传统组件库，是"可复制的组件代码"
• 基于 Radix UI（可访问性）+ Tailwind + CVA
• 优势：完全可控、无版本依赖、可访问性强
• 适合：有 Tailwind 经验、需要高度定制 UI 的团队
• 2023 年在 Next.js 生态里几乎成为默认选择