根本原因是VSCode未读取配置、未识别文件类型或字符串补全关闭；需确保tailwind.config.js在根目录且module.exports导出、content路径显式含扩展名、语言模式设为typescriptreact/html/vue、editor.quickSuggestions.strings设为true。
装了 tailwindcss-intellisense 却没提示，基本不是插件问题，而是 VSCode 没“读到”配置、没识别当前文件类型，或字符串补全被关了——这三处卡住，90% 的场景就失效。
tailwind.config.js 路径和导出格式必须严格对齐
插件只认你执行 code . 打开的那一层目录下的 tailwind.config.js 或 tailwind.config.cjs。它不会向上找父目录，也不会向下钻进 src/ 里。
- 如果配置在
./src/tailwind.config.js，必须在工作区.vscode/settings.json里加："tailwindCSS.experimental.configFile": "./src/tailwind.config.js" - 导出必须用
module.exports = { }；export default { }会静默失败，除非package.json里有"type": "module"且 Node ≥14.18 -
content字段必须显式列出扩展名，例如：["./src/**/*.{js,jsx,ts,tsx,html}"]；写成["./src/**/*"]插件扫不到任何文件，类名索引为空 - 配置里不能有运行时报错：比如
require('missing-package')、fs.readFileSync('not-exist.txt')、await—— 一旦出错，插件直接降级为默认配置，theme.extend全部消失
语言模式不匹配导致补全完全不触发
插件默认只在 html、typescriptreact、vue、astro 等 language ID 下激活。你在 .tsx 文件里写 className=""，但右下角显示的是 TypeScript 或 Plain Text，补全就压根不会启动。
- 点击右下角语言标识，手动切到
TypeScript React（React 项目）或Vue（Vue 项目） - 对非标后缀（如
.page.tsx），在settings.json加映射："files.associations": {"*.page.tsx": "typescriptreact"} - 确保
tailwindCSS.includeLanguages包含对应项，例如："typescriptreact": "html"，否则插件不认为该语言上下文适合解析类名
editor.quickSuggestions.strings 是最隐蔽的开关
Tailwind 类名几乎都写在字符串里：className="text-lg bg-blue-500"。VSCode 默认关闭字符串内的自动提示，这是最高频也最容易被忽略的“没提示”原因。
立即学习“前端免费学习笔记（深入）”；
- 打开设置（
Ctrl+,），搜editor.quickSuggestions，展开后把strings设为true - 改完不用重启 VSCode，但需重新打开当前文件，或执行命令
Developer: Reload Window - 这个开关影响所有字符串提示（比如 JSON 键名、正则字面量），关掉它，连
{"key": ""}里输key都不提示
cn()、tw()、模板字面量需要 classRegex 显式提取
插件默认只解析 HTML 的 class="" 和 JSX 的 className="xxx" 字面量。一旦你用 cn()、tw() 或 tw`text-lg` 包着类名，就得手动告诉插件“从哪儿提取字符串”。
- 在
.vscode/settings.json的tailwindCSS节点下加："tailwindCSS.experimental.classRegex": ["cn\(([^)]*)\)"]（注意双反斜杠转义） - 若用模板字面量，加：
"tailwindCSS.experimental.templateStringRegex": "tw`([^`]*)`" - 动态拼接如
className={`bg-${color}-500`}天然不支持补全——这是设计限制，不是 bug，别折腾正则硬套
真正卡住的人，往往只差一个 editor.quickSuggestions.strings 开关，或右下角语言模式没点对。动态类名永远不补全，这点容易反复试错，但它就是静态分析工具的边界所在。
