Tailwind类名不提示需检查配置文件位置与格式、content路径匹配性、语言模式设置及JIT模式启用情况，重启窗口或查看诊断信息可快速定位问题。
Tailwind插件装了但类名不提示？检查 tailwind.config.js 是否被识别
VSCode 不是靠插件“自动猜” Tailwind 配置，而是读取项目根目录下的 tailwind.config.js（或 tailwind.config.cjs）来提取类名规则。如果配置文件路径不对、导出格式非法，或者用了 ESM 语法但没配 type: "module"，插件就无法加载配置，补全直接失效。
- 确保配置文件在项目根目录（即
code .打开的那层），不是子文件夹里 - 用
module.exports = { ... }而非export default { ... }（除非你明确配了"type": "module"在package.json） - 如果用了
content字段，路径必须能匹配到你的模板文件，比如：content: ["./src/**/*.{js,jsx,ts,tsx,html}"]，否则插件找不到你写的类，也就不会补全
装了 tailwindcss-intellisense 还是没反应？确认语言模式和文件关联
这个插件只对特定语言模式生效：默认是 html、javascript、typescript、vue、astro 等。如果你在 .svelte 或自定义后缀（如 .page.tsx）里写类名，VSCode 可能没把当前文件识别成对应语言，补全就压根不触发。
- 右下角状态栏看当前语言模式，如果不是
HTML或TypeScript React，点它手动改成对应项 - 对非标后缀，可在
settings.json里加映射，例如："files.associations": {"*.page.tsx": "typescriptreact"} - 插件本身不支持纯 CSS 文件里的类名补全（
@apply除外），别在style.css里期待它提示bg-red-500
class 属性里补全慢或漏掉新类？检查 content 扫描范围和 JIT 模式
Tailwind 的类名补全是“静态分析 + 配置驱动”的——插件根据 content 列出的文件内容，提前扫描所有可能的类名组合。如果新增了组件但没被 content 覆盖，或者用了动态拼接（className={`bg-${color}-500`}），补全就看不到那些类。
- 开发中建议开启 JIT 模式（Tailwind v3.0+ 默认开启），它能让插件更准确地模拟运行时生成逻辑
- 避免
content写成["./src/**/*"]—— 太宽泛会拖慢扫描，也容易漏掉某些扩展名；显式列出.js、.tsx、.html更稳 - 动态类名（字符串拼接、变量插值）天然不在补全范围内，这是设计限制，不是配置问题
重启 VSCode 后补全消失？别急着重装插件，先试 Developer: Reload Window
插件依赖 Tailwind 配置加载完成才启动补全服务。有时候配置刚改完、插件还没热更新，或者工作区缓存卡住，就会表现为“明明都对，就是不提示”。硬重启比重装快得多，也更安全。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Developer: Reload Window回车 - 如果还是不行，打开命令面板运行
tailwindcss-intellisense: Show Diagnostics，它会弹出当前配置加载状态和报错详情 - 插件本身不需要额外配置项（如
tailwindCSS.includeLanguages）就能工作，乱加反而可能干扰默认行为
最常被忽略的是 content 路径是否真能访问到文件——比如用相对路径但 VSCode 是从父目录打开的工作区，或者用了别名（@/components）而插件不解析别名。这类问题不会报错，只会静默失效。
