Shadcn/ui 组件迁移：从 Radix UI 到 Base UI，咱来聊聊

嘿，朋友们！你有没有遇到过这样的情况？咱用 Shadcn/ui 搭建项目，感觉挺爽的，各种组件dou拿出来用，可后来发现有个小问题，就是默认还是用着 Radix UI 的组件。 哎呀，这可真让人头疼啊！

咱就是说Shadcn/ui 可是个好东西。它把各种常用的 UI 组件dou打包在一起了。你只需要一个命令就Neng搞定。但是啊，有时候会遇到一些兼容性问题。比如说你想把 Shadcn/ui 的 primitive 组件移到 BaseUI 这个地方。

你懂的，BaseUI 可是个不错的选择。它geng轻量级，也geng适合一些场景。而且现在生态情况嘛……咱就是说官方geng推荐用 BaseUI 了。所以呢，咱要好好地考虑一下怎么把那些组件迁移过来。

呢，你要先确认一下你的项目是不是Yi经安装了 shadcn/ui 了。Ru果还没安装的话，就先执行一下这个命令：

pnpm dlx shadcn@latest add avatar

这个命令会帮你自动安装 avatar 组件到你的项目中。当然啦，Ru果你Yi经安装了 shadcn/ui ，那也没啥关系，咱们就跳过这一步吧。

然后呢，你要去检查一下 components/ui/avatar.tsx 文件开头里的 import 语句是不是指向了 @radix-ui/react-avatar 或者 @radix-ui/react-avatar-element 。 不对不对？应该是指向 @base-ui/react 或者 @base-ui/react-avatar 。 你懂的嘛！就是要改成 BaseUI 的路径！

既然咱们Yi经成功地把 avatar 组件迁移到了 BaseUI 上面了 ，那接下来呢？ 咱要Zuo的就是修改一下 components.json 文件里的配置就行了 。 那个那个... 我发现有些地方需要调整才Neng让一切正常运行 。

在 components.json 文件里面找到 "style": "new-york" 这行代码 。 你Ke以把它改成 BaseUI 支持的 style 名称 ，比如 "base-vega" 。 我一开始没找到合适的配置选项啊 ，感觉有点迷糊 。

pnpm dlx shadcn@latest add avatar

你kan ，这个命令跟之前的一样啊！ 说明 Shadcn/ui 在处理 primitive 组件的时候 ，其实是默认选择 BaseUI 的啦 ！

说到 SEO， 你可Neng想问我：“为什么百度不收录？” 哎呀,这个问题可真是让人头疼啊！ 有些时候 ，即使你写了hen多高质量的内容 ， 也可Neng被百度忽略掉 。 原因有hen多种呢 ！比如关键词不匹配 、内容质量不高 、网站权重低等等… 但是, 我认为其中一个重要的原因 就是网站结构不够清晰 、用户体验不好 。

顺便说一句 ，Radix UI 和 Base UI 虽然douKe以用来构建 primitive 组件 ，但是它们在一些细节上还是有区别的哦 。 Radix UI geng侧重于提供一些高级的功Neng和特性 ，比如 accessibility 和 composability 等等 。而 Base UI 则geng注重于提供一个简洁 、轻量级的组件库 。

pnpm dlx shadcn@latest add button

你kan , 命令一样 , 直接跑起来就Ke以kan到效果! 是不是hen简单?

总而言之 ，把 Shadcn/ui 的 primitive 组件迁移到 BaseUI 上面并不难 。只要你按照上面的步骤操作就Ke以了 。 其实整个过程就像是换了一个衣服而Yi, 一旦换上新的衣服, 就会感觉舒服多了! 希望这篇文章Neng对你有所帮助！