UnoCSS 使用教程

1. 项目介绍

UnoCSS 是一个即时按需的原子化 CSS 引擎，旨在提供快速、可定制的 CSS 解决方案。它受到 Windi CSS、Tailwind CSS 和 Twind 的启发，但具有以下特点：

• 完全可定制：没有核心工具，所有功能均通过预设提供。
• 即时生成：无需解析、AST 或扫描，速度比 Windi CSS 或 Tailwind JIT 快 5 倍。
• 轻量级：仅约 6kb（min+brotli），无依赖，浏览器友好。
• 功能丰富：支持快捷方式、属性化模式、纯 CSS 图标、变体组、CSS 指令、编译模式、检查器等。

2. 项目快速启动

安装

首先，确保你已经安装了 Node.js 和 npm。然后，通过以下命令安装 UnoCSS：

npm install unocss

配置

在你的项目根目录下创建一个 uno.config.ts 文件，并添加以下内容：

import { defineConfig } from 'unocss'

export default defineConfig({
  // 配置选项
})

使用

在你的项目中引入 UnoCSS：

import 'uno.css'

示例

以下是一个简单的示例，展示如何使用 UnoCSS 快速构建一个按钮：

<button class="bg-blue-500 text-white px-4 py-2 rounded">
  点击我
</button>

3. 应用案例和最佳实践

案例1：响应式布局

UnoCSS 支持响应式布局，可以通过添加前缀来实现不同屏幕尺寸下的样式调整。例如：

<div class="grid grid-cols-1 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4 gap-4">
  <!-- 内容 -->
</div>

案例2：动态样式

UnoCSS 支持动态样式，可以通过 JavaScript 动态修改类名来实现样式的变化：

const button = document.querySelector('button')
button.classList.toggle('bg-blue-500')
button.classList.toggle('bg-red-500')

最佳实践

• 使用预设：UnoCSS 提供了多种预设，可以根据项目需求选择合适的预设。
• 避免过度定制：虽然 UnoCSS 完全可定制，但过度定制可能会导致维护困难。
• 利用检查器：UnoCSS 提供了检查器工具，可以帮助你调试和优化样式。

4. 典型生态项目

Vite

UnoCSS 与 Vite 集成非常方便，可以通过插件快速配置：

import { defineConfig } from 'vite'
import UnoCSS from 'unocss/vite'

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

Nuxt

UnoCSS 也支持 Nuxt 项目，可以通过以下方式集成：

export default {
  buildModules: [
    'unocss/nuxt',
  ],
}

Webpack

对于 Webpack 项目，可以通过以下方式配置 UnoCSS：

const UnoCSS = require('unocss/webpack').default

module.exports = {
  plugins: [
    new UnoCSS(),
  ],
}

通过以上步骤，你可以快速上手并使用 UnoCSS 构建高效、可定制的 CSS 解决方案。