Tailwind CSS IntelliSense插件需正确配置tailwind.config.js路径、导出格式、语言模式、字符串提示开关及content字段才能生效，任一环节错误均导致无提示。
装了插件但 class 里没提示，90% 是配置没对上，不是插件坏了。 Tailwind CSS IntelliSense（作者 bradlc）是唯一稳定可用的方案，其他名字带 “tailwind” 的补全插件基本不维护或只做半吊子支持。它必须读取真实存在的 tailwind.config.js 才能生效，不是“装完就自动有提示”。
插件装完没反应？先确认 tailwind.config.js 路径和导出格式
VSCode 不会自动扫描子目录找配置文件。插件只认项目根目录（即你执行 code . 打开的那一层）下的 tailwind.config.js 或 tailwind.config.cjs。
- 如果配置在
src/tailwind.config.js，必须在工作区.vscode/settings.json里加："tailwindCSS.experimental.configFile": "./src/tailwind.config.js" - 导出必须用
module.exports = { }；若用了export default { }，得在package.json里加"type": "module"，否则插件静默失败 - 哪怕只是空配置，也得存在且语法合法：
module.exports = {} - 删掉
node_modules/.cache/tailwindcss和 VSCode 窗口缓存后重启（不是重载），再试
TSX/JSX 文件里 className 没提示？检查语言模式和字符串提示开关
插件默认只在 html、typescriptreact、vue 等语言模式下激活。你在 .tsx 里写 className=""，但右下角显示的是 TypeScript 或 Plain Text，补全压根不会触发。
- 点右下角语言模式，手动切到
TypeScript React - 在
settings.json加映射："files.associations": {"*.tsx": "typescriptreact"} - 关键隐藏开关：
editor.quickSuggestions.strings必须设为true—— VSCode 默认关掉字符串内的提示，这是最常被忽略的一环 - React 场景下，确保
"tailwindCSS.classAttributes"包含"className"（默认已含，但自定义属性如cls需手动加）
自定义颜色/断点不出现？content 路径和 theme.extend 要同步生效
插件靠 content 字段扫描文件内容来提取类名组合。如果路径没覆盖到你写类名的地方，或者 theme.extend 里的值没被静态分析到，提示里就只有默认值。
立即学习“前端免费学习笔记（深入）”；
-
content必须显式列出扩展名：["./src/**/*.{js,jsx,ts,tsx,html}"]，别写成["./src/**/*"]（漏匹配、还拖慢） - 动态拼接的类名如
className={`bg-${color}-500`}永远不补全——这是设计限制，不是 bug，别折腾正则去硬套 - 想让
theme.extend.colors.brand出现在提示里，除了配置正确，还得确保至少一个被content扫到的文件里实际写了text-brand-500或类似用法（哪怕只是注释） - 如果用了
@layer utilities自定义工具类，插件无法自动识别，建议在某个常驻文件（如src/tailwind-hint.css）里加一行注释：/* text-brand-500 bg-primary */，并把它加进content
提示卡顿、报 “Cannot resolve config”？检查配置文件里的 JS 逻辑
插件加载 tailwind.config.js 时会执行其中的 JS 代码（比如 require()、fs.readFileSync、动态生成 theme）。一旦出错，它就降级为只用默认配置，且不报明显错误。
- 删掉配置里所有异步操作、未处理的
require()、或引用不存在的 Node 模块（比如require('postcss')但没装） - 避免在配置里读取环境变量或调用外部 CLI 工具——这些在插件运行时不可用
- 如果用了 JIT 模式（v3.0+ 默认开启），确保
content路径真实存在且可读，否则插件反复重试导致卡顿 - 性能敏感时，可临时把
"tailwindCSS.validate.tailwindcssVersion"设为具体版本号（如"3.4.3"），跳过自动探测
最麻烦的不是配置项多，而是每一步都依赖前一步成功：路径不对 → 配置不加载 → 语言模式错 → 字符串提示关 → 动态类名硬要补全……任一环节断掉，提示就消失。改完记得重启窗口，不是重载，不是重开文件，是彻底关掉再打开。
