UnoCSS 样式不生效主因是类名未被扫描、未生成或未注入/未匹配；需检查 main.ts 是否引入 'uno.css'、content 路径是否覆盖 .ts 文件、是否启用 vue-scoped 模式及 VSCode 提示配置。
UnoCSS 在 Vue 3 项目中样式“不生效”，90% 的情况不是引擎坏了，而是类名根本没被扫描到、没被生成，或者生成了但没注入/没匹配上。先确认是不是这三类问题之一，再动手改。
检查 uno.css 是否在入口文件中正确引入
UnoCSS 不像传统 CSS 那样自动收集所有类名——它靠构建时静态扫描 + 运行时注入。如果入口文件（通常是 src/main.ts）里没显式 import 'uno.css'，整个样式系统就启动不了。
- 打开
src/main.ts，确认顶部有这一行：import 'uno.css' - 如果用的是 Vite，且配置了
content路径但漏掉了.ts文件，main.ts里的 import 可能被忽略——建议把content设为['src/**/*.{vue,ts,js}'] - 若使用了
unocss/vite插件但没配enforce: 'pre'，Vite 可能先处理其他插件（比如 Vue 插件），导致uno.css没被识别为 CSS 模块而跳过注入
动态类名（如 :class="`text-${color}`"）不生效的典型原因
UnoCSS 默认只提取代码中**字面量出现**的类名，text-red 会被捕获，text-${color} 则完全不可见——构建阶段变量还没值，扫描器看到的是字符串模板，不是具体类名。
- 最稳妥方案：提前声明所有可能组合，例如
const staticClasses = ['text-red', 'text-green', 'text-blue']，哪怕只是放在某个// @unocss-include注释下，也能让扫描器捕获 - 进阶方案：启用
@unocss/transformer-directives，在<style>中用--at-apply: 'text-${color}'，它会在编译期解析变量值并生成对应规则 - 避免写
:class="{ 'text-red': cond }"后又在子元素依赖该 class 的后代选择器（如.text-red .icon），nvue 或 scoped 场景下这类链式选择器基本无效
Vue 组件中 scoped 样式与 UnoCSS 冲突
启用 mode: 'vue-scoped' 后，UnoCSS 会把 text-red-500 转成 text-red-500[data-v-xxx]，但前提是它得知道这个 class 出现在带 scoped 的组件里。否则仍按全局规则生成，导致优先级低于组件内 <style scoped> 的样式。
vue-admin-change-reviewer
下载
审查 Vue 管理后台的变更请求（Vue 2 + Element UI，Vue 3 + Element Plus）。重点关注最小化变更实现、上线风险检查以及回归检查清单生成。
立即学习“前端免费学习笔记（深入）”；
- 必须在
uno.config.ts中显式设置mode: 'vue-scoped'，仅靠 Vite 插件默认配置是不够的 -
<style scoped>和 UnoCSS 原子类共存时，注意属性选择器的优先级：UnoCSS 生成的.p-4[data-v-xxx]和你自己写的.container[data-v-xxx] { padding: 1rem }是平级的，后者不会覆盖前者 - 如果用了
transformer-attributify，记得加ignore配置，否则v-if、v-model这类 Vue 指令可能被误识别为类名，引发构建报错或样式污染
VSCode 智能提示不出现，间接导致你以为“样式没生效”
提示不弹，你手敲 flex-col 时不确定拼写对不对、有没有这个类，于是删掉重试——结果真没生效，其实是敲错了，不是引擎问题。
- 确保项目根目录存在
uno.config.ts，VSCode UnoCSS 插件靠它激活，缺了就静默 - 检查
.vscode/settings.json是否启用了"unocss.enable": true，并开启字符串内提示："editor.quickSuggestions": { "strings": true } - 如果用了自定义预设（比如
presetIcons），但没在配置里显式调用presets: [presetIcons()]，图标类名（如i-carbon-logo）就不会出现在提示列表里
真正难排查的点往往藏在「扫描路径没覆盖到」和「scoped 模式开关没开」这两处，其他多数问题都是配置项漏写或拼写偏差。别急着换工具，先看控制台有没有 [unocss] 开头的警告，那通常就是最直接的线索。
