shadcn/ui 旧版学习记录
保留早期 shadcn/ui 学习语境和旧 CLI 记录;当前用法统一指向主资源笔记。
#frame
#concept
#growing
[!info] related notes
- 主笔记:shadcn/ui 组件库
- 入口:React MOC
shadcn/ui 旧版学习记录
这是早期学习记录的保留入口。源码分发、依赖管理、变体示例和当前 CLI 用法已收敛到 主资源笔记。
旧记录的语境
- 当时围绕 Radix UI + Tailwind CSS + Lucide + cva 学习组件组合;不要把这组依赖视为所有版本和所有组件的固定清单。
- 旧记录使用
npx shadcn-ui@latest init/add button。这是旧 CLI 名称,当前使用shadcn;原命令旁粘连的引用编号不是命令参数。 - 旧记录以组合 Dialog、Button、Command 构建命令面板为例。旧代码缺少子组件导入,也没有完整实现快捷键,因此不保留为“可运行示例”。
- 定制可以直接修改组件源码,也可包装稳定接口;包装不能消除依赖升级或上游 API 变化的风险。
- 按需导入图标、学习 headless 组件组合仍有价值;组件数量“30+”和固定的框架适用性比较已不适合作为当前选型依据。
原笔记所说的 theme.js 不是通用必需文件;主题配置应按项目的 Tailwind 主版本处理,见主笔记。源码开放也不代表没有依赖或无需维护升级。
原参考
- shadcn/ui 官方仓库
- Radix UI
- 原社区讨论链接(保留出处,不作为当前 API 依据)