shadcn/ui 当前在 GitHub 上有 122.7k star、10.1k fork，2,419 次提交由 631 名贡献者完成，下游依赖项目超过 2.6 万个。它和多数 UI 组件库的关键区别不在组件数量，而在分发方式：不把组件作为 npm 依赖安装，而是把源码复制进开发者自己的项目。复制之后，这段代码就是开发者自己的代码。2026 年 8 月 31 日发布的最新版本 shadcn@4.19.1，是项目的第 120 个 release。
组件是复制进项目的源码
大多数 UI 库的交付物是打包好的 npm 包：在 package.json 里声明依赖，再 import 组件，样式与实现留在 node_modules 里由上游维护。shadcn/ui 走的是另一条路：把设计好的组件源码复制进项目，之后可以逐行修改、按需扩展，据此搭建自己的组件库。README 把这一模式概括为「Start here then make it your own」——从官方代码起步，再把它变成你自己的。
这种模式改写了维护关系：改样式不需要覆盖上游写法，也不用等项目出新配置项，直接改自己仓库里的代码；相应的，官方改进组件实现后，升级需要手动同步代码差异。
技术底座：无头组件基座与 Tailwind CSS
组件本身不从头造交互轮子。可访问性与交互逻辑来自无头（headless，指只做行为逻辑、不管样式）基座，仓库 topics 里列着 Radix UI、React Aria、Base UI、TanStack；样式由 Tailwind CSS 工具类表达；代码以 TypeScript 为主（占 87.2%），采用 MIT 许可证。无头基座处理键盘导航、焦点管理、ARIA 属性等细节，改外观则直接改 class，不需要替换整套样式体系。
仓库 About 将项目定义为「精心设计、可访问的组件集合与代码分发平台」，并写明「可与任意你喜欢的框架配合」（Works with your favorite frameworks）：topics 里除 react 相关标签外，还挂着 nextjs、vite、laravel 等框架标签。
v4 现状：monorepo 与 registry
代码组织为 pnpm monorepo：apps/v4 存放 v4 应用，packages 下分布多个包（如 @shadcn/react），另有面向社区贡献的 registry 组件注册中心，2026 年 8 月 25 日的合作为其加入健康监控。2026 年 9 月 1 日的最新提交是一次 v4 性能优化（perf(v4): use cn for class merging，#11730）；全仓库累计 120 个 release，仍保持高频合并。
复制粘贴模式的规模与原因
GitHub 显示依赖它的项目超过 2.6 万个，复制粘贴模式已被大量项目接受。它对应两个实际需求：团队建自己的设计系统时，组件代码落在自家仓库，改版不必跟随上游节奏；组件行为在源码里直接可见、可直接调试，不需要隔着依赖层排查。
选型参考
shadcn/ui 把组件分发从「装依赖」改成「分发代码」，把组件所有权交回开发者。为 React 项目选组件方案时可以这样对照：要开箱即用、自动升级，常规 npm 组件库更省事；要把组件纳入自己长期维护的设计系统，shadcn/ui 的路线有 122.7k star、2.6 万下游项目与持续到 2026 年 9 月 1 日的活跃提交作规模证据。