用途:shadcn/ui 是用于构建 UI、组件与设计系统的框架,组件以源代码形式通过 CLI 添加到用户项目中。
主要能力:用 npx shadcn@latest info --json 读取项目配置与已安装组件;用 npx shadcn@latest docs <component> 获取组件文档、示例与 API URL;用 search 查找注册表组件;用 add 安装或更新组件;用 view 浏览未安装的注册表项;用 apply --preset <code> 或 init --preset <code> 应用预设。
使用方式:所有 CLI 命令需按项目 packageManager 选择运行器,如 npx shadcn@latest、pnpm dlx shadcn@latest 或 bunx --bun shadcn@latest。先查看项目上下文与已安装组件,再运行 docs 并抓取 URL,然后 add;第三方注册表组件需按项目别名修正导入。更新时先用 --dry-run 与 --diff 预览再合并,不得手动从 GitHub 拉取文件。预设切换需先询问用户选择覆盖、合并或跳过。
适用场景:组件选择、表单与输入、数据展示、导航、浮层、反馈、命令面板、图表、布局、空状态、菜单、提示等界面开发。
限制与规则:优先复用已有组件,使用内置 variant 与语义颜色;禁止 space-x-/space-y-,改用 flex 与 gap-;相等宽高用 size-;表单用 FieldGroup + Field;项目上下文含 aliases、isRSC、tailwindVersion、base、iconLibrary、resolvedPaths、framework、packageManager 等关键字段。资料未提供具体收费、价格与效果信息。