问答记录
shadcn/ui 组件必须通过 CLI 安装而非手动创建
创建于 2026/7/15更新于 2026/7/15
shadcn/ui
CLI
Dependencies
踩坑
## 问题描述
手动创建 shadcn/ui 组件文件后,出现编译错误:
```
Module not found: Can't resolve '@radix-ui/react-slot'
```
或
```
Error: Missing required prop `asChild`
```
## 根本原因
shadcn/ui 组件依赖特定版本的 radix-ui 基础组件和其他 peer dependencies,手动创建组件文件无法自动安装这些依赖。
## 解决方案
始终通过 CLI 安装 shadcn/ui 组件:
```bash
npx shadcn-ui@latest add <component-name>
```
遇到依赖冲突时使用:
```bash
npx shadcn-ui@latest add <component-name> --legacy-peer-deps
# 或
npx shadcn-ui@latest add <component-name> --force
```
关联知识资产
QA
资产 ID: 15c6c168-a896-42f6-aab0-de0fc598a448