用途:shadcn CLI 把注册表中的组件源码复制到项目,文件是被复制而非安装,因此项目拥有并可修改这些文件。CLI 是添加组件的唯一官方方式,手工从文档站复制会失去依赖解析和命名空间寻址。
主要能力:init 初始化 components.json 与依赖;add 复制组件;view 预览注册表条目;search 浏览注册表;apply 应用主题/字体预设;preset decode 查看预设;build 为发布者生成注册表 JSON;docs 获取组件文档;info 打印解析后的配置;migrate icons/radix/rtl 执行三类迁移。add 支持裸名称、命名空间、远程 URL 和本地路径四种形式,也可安装 block 多文件脚手架。
用法:始终使用 pnpm dlx shadcn@latest <cmd> 或 npx shadcn@latest <cmd>,不要用 npm install shadcn-ui(已过时的旧包)。没有 diff 子命令,更新流程是 add <name> --diff 预览再 add <name> --overwrite 应用。对已修改的组件务必先 --diff 再 --overwrite,因为覆盖不会保留本地修改。
components.json:style、tailwind.baseColor、tailwind.cssVariables 在 init 后实际不可逆,改动后需重跑 init -f 与 add --overwrite --all。Tailwind v3 需填 tailwind.config,v4 需省略该字段。别名可用 tsconfig paths 或 package.json#imports,但不要两处同时定义同一别名。自定义注册表使用 {name} 占位符并支持 ${ENV_VAR} 插值,不要把密钥硬编码进 URL 或 headers。
限制:本次资料仅覆盖该技能自身说明与上述命令,未提供价格、平台支持范围或性能数据,这些暂未提供。