node_modules),样式与行为完全由你掌控。
什么场景适合用 shadcn/ui
- 你需要在 sidebar、popup 与 options 等界面之间复用可用的 UI 原子组件。
- 你在产品代码里已经使用 React + Tailwind。
- 你希望组件由源码自有,团队可以完全自定义。
shadcn/ui 的能力
模板示例
Sidebar + shadcn/ui 模板
把sidebar-shadcn 模板作为默认起点:

技术栈假设
- React + TypeScript
- Tailwind CSS
- PostCSS(
@tailwindcss/postcss) - 本地
components/ui/*组件文件(shadcn 风格的结构)
在现有项目中手动配置
- 设置 Tailwind 和 PostCSS(参见 Tailwind CSS)。
- 在项目里初始化 shadcn 并生成组件。
- 把生成的 UI 组件放在扩展源码里(例如
src/components/ui/)。 - 在需要渲染 UI 的扩展入口中引入 Tailwind 样式表。
PostCSS 示例(Tailwind v4)
components.json 示例
用法
通过本地导入使用生成的组件:Content script 注意事项
- 扩展页面(popup/options/sidebar/新标签页)是最容易上手 shadcn/ui 的地方。
- 在 content script 里,单纯的
import "./styles.css"求值得到的是这份样式表的 URL。它本身不会给任何东西加样式。 - Extension.js 只在一种情况下替你放置这份样式表。这条导入必须写在已声明 content script 的入口文件里,而且脚本必须用
data-extension-root标记一个宿主元素。 - 样式表随后进入这个宿主的 shadow root。把组件挂载到这个 shadow root 里,Tailwind 样式表才能作用到它们。
最佳实践
- 把 shadcn/ui 视作源码自有的组件,而不是运行时引入的 UI 包。
- 让 Tailwind 的配置与 content 路径与扩展目录保持一致(
pages、scripts、src)。 - 先从一个界面(比如 sidebar 或 popup)开始,再去面对 content script 渲染的复杂度。
- 把共享的 token 与工具函数放到专门的文件里(
lib/utils、设计 token、主题变量)。
下一步
- 如果还没有,先设置 Tailwind CSS。
- 用 ESLint 和 Prettier 增加 lint 与格式化。

