Windi CSS插件无提示需先确认windi.css存在于根目录且被import；若放子目录需配置scan.dirs；必须删除或重命名tailwind.config.js；Vue中:class等动态绑定不支持提示。
Windi CSS插件装了但没提示？检查 windi.css 是否在项目根目录
Windi CSS 的 VSCode 智能提示依赖插件自动扫描项目中的 windi.config.ts（或 .js）和入口 CSS 文件。如果提示不生效，第一件事不是重装插件，而是确认：windi.css 是否真实存在于项目根目录（如 src/windi.css 或 styles/windi.css），且该文件里至少有一行 @layer base {} 或 @apply 用法。插件不会主动创建这个文件——它只扫描已存在的、被 import 过的 CSS 入口。
- 常见错误：只配了
windi.config.ts，但没建windi.css，也没在main.ts或App.vue中import './windi.css' - VSCode 插件（
Windi CSS IntelliSense）默认只监听根目录下的*windi*.css和style.css等常见名，不递归扫描src/css/下的任意路径 - 如果你把 windi.css 放在非根目录（比如
src/styles/windi.css），需在windi.config.ts中显式设置scan: { dirs: ['./src/styles'] }，否则插件无法定位上下文
tailwind.config.js 能不能混用？不能，必须删或重命名
Windi CSS 和 Tailwind CSS 的配置文件虽然结构相似，但运行时互斥。VSCode 插件一旦检测到项目中存在 tailwind.config.js（哪怕内容为空），会自动降级为 Tailwind 模式，导致 @apply 提示缺失、dark: 变体不识别、peer- 类无补全——所有 Windi 特有功能全部失效。
- 务必删除或重命名为
tailwind.config.js.bak；仅靠注释掉内容无效 - Windi 的配置文件名必须是
windi.config.ts或windi.config.js，且导出对象中要有extractors或attributify等 Windi 特有字段，插件才能确认启用 Windi 模式 - 若你用 Vite + Windi，还需确认
vite.config.ts中已移除tailwindcss插件，只保留WindiCSS()
HTML/Vue/Svelte 中 class 属性没提示？检查 scan.template 配置
Windi CSS 插件默认只扫描 .html 和 .vue 文件里的 class 属性，但对 :class（Vue 响应式绑定）、class:list（Svelte）、JSX 中的 className 不开箱即用。提示失效往往是因为模板扫描范围没打开或路径没覆盖。
- 在
windi.config.ts中必须显式开启：scan: { template: true, fileExtensions: ['html', 'vue', 'svelte', 'tsx'] } - Vue 用户注意：
class="text-2xl"能提示，但:class="{ 'text-2xl': visible }"中的类名不会被提取——Windi 目前不解析 JS 表达式，只提取字符串字面量 - 使用
attributify模式时（如bg-gray-100 rounded p-4写成），需额外加 attributify: true，否则插件不识别这种写法
重启 VSCode 后提示仍不出现？手动触发扫描或检查日志
插件启动后不会实时监听所有文件变更，尤其首次安装或配置改动后，常需手动刷新上下文。别急着卸载重装。
立即学习“前端免费学习笔记（深入）”；
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入并执行Windi CSS: Reload - 如果仍无效，在 VSCode 底部状态栏找到
Windi CSS图标，点击可查看当前扫描结果（如 “Scanned 12 files” 或 “No config found”） - 关键错误通常出现在 Output 面板 → 选择
Windi CSS，常见报错：Failed to resolve config（路径错）、No CSS entry found（windi.css 缺失）、Cannot find module 'windicss'（没装windicss包，仅装插件不够）
