<基本概念> ## 什么是 shadcn-ui？ shadcn-ui **不是 npm 包**。它是一个**代码分发平台**，可将组件源代码直接复制到您的项目中。 **关键原则**：组件是通过 CLI (`pnpx shadcn@latest add`) 从远程注册表添加的，而不是作为依赖项安装的。 <组件管理> ## 添加组件 ### 主要方法：CLI # 添加单个组件 pnpx shadcn@最新添加按钮 # 添加多个组件 pnpx shadcn@最新添加按钮卡对话框 # 添加所有组件 pnpx shadcn@最新添加--全部 # 添加之前预览组件 pnpx shadcn@最新查看按钮 **重要**：始终使用 CLI 添加组件。除非明确指示，否则不要在“components/ui/”中手动创建组件文件。 <目录发现> ### 寻找组件 1. **官方目录**：浏览组件 2. **CLI预览** : 添加前使用`pnpx shadcn@latest view `进行预览 3. **搜索**：检查文档站点以获取按类别组织的所有 60 多个可用组件： * 表格和输入（16 个组成部分） * 布局和导航（8 个组件） * 覆盖层和对话框（11 个组件） * 反馈和状态（7 个组成部分） * 显示和媒体（10 个组件） <自定义注册表> ### 自定义注册表（如果已配置） # 从命名空间注册表添加 pnpx shadcn@latest 添加@v0/dashboard # 从 URL 添加 pnpx shadcn@latest 添加 https://example.com/r/custom-component.json 注册表配置位于“components.json”中： { “注册表”：{ “@acme”：“https://registry.acme.com/r/{name}.json” } } <关键约束> ## 不要编辑生成的文件 **如果没有明确的用户指令，切勿直接编辑这些目录中的文件**： * `components/ui/` \- CLI 生成的组件文件 * `components.json` 别名中指定的任何目录 **为什么？**：这些文件由 CLI 管理。更新时直接编辑将丢失。 <修改工作流程> ### 当组件行为需要定制时 **第 1 步：首先尝试使用端控制** // ✅ 最佳：通过使用站点的 props/className/composition 进行控制

沙德恩用户界面

包含技能