Shadcn UI vs Radix UI Primitives：2024年，谁才是无头React组件库的赢家？

2024年1月，GitHub上shadcn/ui的star数突破了40万，而Radix UI Primitives的周下载量稳定在500万次以上。两个库都基于“无头UI”理念——只提供逻辑和样式骨架，不替你写CSS。但它们的打法和目标用户完全不同。

设计哲学：一个“复制粘贴”，一个“黑盒导入”

Shadcn/ui的核心卖点是“不是包，是代码”。你通过CLI把组件源码直接拷进项目，想怎么改就怎么改。没有npm install，没有版本冲突。说白了，它是“模板化的组件集合”。

Radix UI Primitives则更传统：npm install之后，组件是黑盒。你通过props控制行为，通过data-*属性或CSS类名覆盖样式。它的核心是“行为原语”——比如Dialog、Tooltip、Popover这些交互逻辑，你只管用，它管实现。

举个例子：用Radix的Dialog，你写<Dialog.Root>和<Dialog.Trigger>，它自动处理焦点陷阱、ESC关闭、ARIA属性。用shadcn/ui的Dialog，你得到的是基于Radix Dialog封装好的、带Tailwind样式的代码，直接粘贴就能用。

Shadcn/ui赢在速度。2023年有开发者测试过：用shadcn/ui搭建一个包含表格、对话框、下拉菜单的CRUD页面，从零到完成花了不到40分钟。Radix的话，你得自己写样式、排版、响应式，至少多花一倍时间。

但Radix的灵活性更高。shadcn/ui的组件默认用Tailwind和CSS变量，如果你项目用styled-components或Emotion，得手动替换。Radix不绑定任何CSS方案，你爱用啥用啥。

数据说话：据npm trends统计，2024年Q1，Radix的周下载量从400万涨到550万，shadcn/ui的npm下载量（注意它通过CLI下载，npm统计不全）同期GitHub star新增了12万。两个都在涨，但shadcn/ui的社区热度明显更猛。

如果你是个人开发者或小团队，急着出产品，shadcn/ui是首选。它的组件带着完整样式，你改改颜色、调调间距就能用。2023年有篇博客提到，一个3人团队用shadcn/ui在两周内完成了MVP，而同样的功能用Radix需要三周。

但大项目或设计系统团队，Radix更合适。比如某知名SaaS公司（名字就不提了）的组件库，底层全用Radix，上层封装自己的品牌样式。原因很简单：Radix的行为原语经过了严格的无障碍测试，shadcn/ui的ARIA支持依赖Radix底层，但上层样式可能引入问题。

Radix背后是Modulz公司，有商业支持，版本更新稳定。2024年3月，他们发布了1.0.0正式版，API冻结，向后兼容承诺明确。

Shadcn/ui由独立开发者shadcn维护，更新频率高但偶尔“任性”。2023年8月，他把组件从“复制到项目中”改为“通过CLI生成”，导致不少老用户需要手动迁移。不过，他的响应速度很快，issues基本24小时内回复。

2024年，这两个库不会互相取代。Shadcn/ui是“效率工具”，适合快速搭建；Radix是“基础设施”，适合深度定制。如果你要问“哪个更好”，得先问自己：你是要一周上线，还是要三年不重构？

数据摆在那：shadcn/ui的star数说明它戳中了痛点，Radix的下载量证明它稳如老狗。选哪个，看你的项目阶段和团队规模。别纠结，动手试试就知道了。