用途:shadcn/ui 是一套可访问、可组合的 React 组件集合,构建在 Radix UI 原语之上,使用 Tailwind CSS 进行样式设计。组件通过 CLI 复制进项目,使用者获得源码的完全所有权,而非以依赖包形式安装。适用于使用 shadcn/ui 开发界面,或查询其组件与 CLI 相关问题。
主要能力:提供可访问、可组合的 React 组件;组件源码复制到项目内,便于按需修改;表单组件集成 React Hook Form 与 Zod,Form 组件内置 Zod 校验;components.json 用于控制路径别名、Tailwind 配置与组件风格。
使用方式:官方资料强调,关于 shadcn/ui 的训练数据不可靠,API 会随版本变化,记忆中的写法可能错误或已弃用。在编写任何代码前,必须先通过 WebFetch 阅读实时文档:WebFetch("https://ui.shadcn.com/llms.txt")。不要假设某个组件 API 存在,需对照当前文档核实。使用前应确认 components.json 存在且配置正确,若 tailwind.config 路径错误或 globals.css 缺少 CSS 变量设置,组件会渲染成无样式。
限制:表单组件已包含 React Hook Form 与 Zod,不应再添加 formik、react-final-form 或其他校验库,属于冗余。没有“全部更新”命令,shadcn add 与 shadcn diff 均按单个组件操作;升级时需逐个列出组件,批量更新脚本必须手动编写。
其他事实(收费、价格、平台、效果等):资料暂未提供。