close
logologo
指南
配置
插件
API
社区
版本
更新日志
Rsbuild 0.x 文档
English
简体中文
指南
配置
插件
API
社区
更新日志
Rsbuild 0.x 文档
English
简体中文
logologo

开始

介绍
快速上手
功能导航
名词解释

框架

React
Vue
Preact
Svelte
Solid

基础

命令行工具
开发服务器
构建产物
静态资源
HTML
JSON
Wasm
TypeScript
Web Workers
部署静态站点
升级 Rsbuild

配置

配置 Rspack
配置 Rsbuild
配置 SWC

样式

CSS
CSS Modules
CSS-in-JS
Tailwind CSS v4
Tailwind CSS v3
UnoCSS

进阶

路径别名
环境变量
模块热更新
浏览器范围
浏览器兼容性
模块联邦
多环境构建
服务端渲染(SSR)
测试

优化

代码拆分
产物体积优化
提升构建性能
静态资源内联

迁移

从 Rsbuild 0.x 迁移
webpack
Create React App
Vue CLI
Vite
Vite 插件
Modern.js Builder

调试

开启调试模式
构建性能分析
使用 Rsdoctor

常见问题

通用类问题
功能类问题
异常类问题
热更新问题
📝 在 GitHub 上编辑此页
上一页Tailwind CSS v3
下一页路径别名

#UnoCSS

UnoCSS 是一个灵活可扩展的原子化的 CSS 引擎,所有 CSS 工具类都是通过 preset 提供的。

你可以通过 PostCSS 插件来在 Rsbuild 中接入 UnoCSS。

#安装 UnoCSS

首先,你需要安装 unocss 和 @unocss/postcss。

npm
yarn
pnpm
bun
npm add unocss @unocss/postcss -D

#配置 PostCSS

你可以通过 postcss.config.mjs 或 tools.postcss 来注册 unocss 的 PostCSS 插件。

postcss.config.mjs
import UnoCSS from '@unocss/postcss';

export default {
  plugins: [UnoCSS()],
};

#配置 UnoCSS

在当前项目的根目录创建 uno.config.ts 文件,并添加以下内容:

uno.config.ts
import { defineConfig, presetUno } from 'unocss';

export default defineConfig({
  content: {
    filesystem: ['./src/**/*.{html,js,ts,jsx,tsx}'],
  },
  presets: [presetUno()],
});
TIP

上述配置仅供参考,你可以根据项目需要进行调整。

#引入 CSS

在 CSS 入口文件中添加 @unocss 指令:

main.css
@unocss preflights;
@unocss default;

根据需求不同,你可以选择性地导入 UnoCSS 提供的 CSS 样式。请参考 UnoCSS 文档 来了解 @unocss 指令的详细用法。

#完成

你已经完成了在 Rsbuild 中接入 UnoCSS 的全部步骤!

你可以在任意组件或 HTML 中使用 UnoCSS 的 utility classes,比如:

<h1 class="px-2 items-center justify-between">Hello world!</h1>

更多用法请参考 UnoCSS 文档。

#VS Code 插件

UnoCSS 提供了 VS Code 插件,用于在 VS Code 中提示 UnoCSS 的 utilities classes。

你可以在 VS Code 中安装该插件,即可开启更多智能化功能。