Vite React项目引入unocss 及 @unocss/preset-icons的使用

安装相关npm包

pnpm add -D unocss @unocss/preset-icons @iconify/utils

启用unocss

// vite.config.ts
import { defineConfig } from "vite";
import react from "@vitejs/plugin-react-swc";
import unocss from "unocss/vite";export default defineConfig({plugins: [react(),unocss()]
});

重中之重！！！

网上大部分的教程都没有指出来！！！

一定要在全局引入unocss的样式文件 ！！！

一定要在全局引入unocss的样式文件 ！！！

一定要在全局引入unocss的样式文件 ！！！

import { createRoot } from 'react-dom/client'
import App from './App.tsx'
import 'virtual:uno.css';createRoot(document.getElementById('root')!).render(<App />)

创建unocss 配置文件 uno.config.ts

// uno.config.ts
import {defineConfig,presetAttributify,presetIcons,presetTypography,presetWind3,presetWebFonts,transformerDirectives,transformerVariantGroup,
} from "unocss";import { FileSystemIconLoader } from "@iconify/utils/lib/loader/node-loaders";
import fs from "fs";// 本地SVG图标目录
const iconsDir = "./src/assets/icons";// 读取本地 SVG 目录，自动生成 safelist
const generateSafeList = () => {try {return fs.readdirSync(iconsDir).filter((file) => file.endsWith(".svg")).map((file) => `i-svg:${file.replace(".svg", "")}`);} catch (error) {console.error("无法读取图标目录:", error);return [];}
};export default defineConfig({// 自定义快捷类shortcuts: {"wh-full": "w-full h-full","flex-center": "flex justify-center items-center","flex-x-center": "flex justify-center","flex-y-center": "flex items-center","flex-x-start": "flex items-center justify-start","flex-x-between": "flex items-center justify-between","flex-x-end": "flex items-center justify-end",},theme: {colors: {primary: "var(--el-color-primary)",primary_dark: "var(--el-color-primary-light-5)",},breakpoints: Object.fromEntries([640, 768, 1024, 1280, 1536, 1920, 2560].map((size, index) => [["sm", "md", "lg", "xl", "2xl", "3xl", "4xl"][index],`${size}px`,])),},presets: [presetWind3(),presetAttributify(),presetIcons({// 额外属性extraProperties: {display: "inline-block",width: "1em",height: "1em",},// 图表集合collections: {// svg 是图标集合名称，使用 `i-svg:图标名` 调用svg: FileSystemIconLoader(iconsDir, (svg) => {// 如果 `fill` 没有定义，则添加 `fill="currentColor"`return svg.includes('fill="')? svg: svg.replace(/^<svg /, '<svg fill="currentColor" ');}),},}),presetTypography(),presetWebFonts({fonts: {// ...},}),],safelist: generateSafeList(),transformers: [transformerDirectives(), transformerVariantGroup()],
});

使用svg图标

下载的svg文件，放在src\assets\icons\add.svg

<div className="i-svg:add w-[10px] h-[10px]"></div>