Tailwind提示失效的三大主因是配置未被读取、语言模式不匹配、字符串补全关闭：需确保tailwind.config.js在项目根目录且module.exports导出，content路径显式含扩展名，右下角语言模式设为TypeScript React/HTML/Vue，并开启editor.quickSuggestions.strings。
装了 bradlc.vscode-tailwindcss 却没提示？不是插件坏了，是它根本没读到你的配置、没识别当前文件类型，或者字符串补全被关了——这三处错一个，补全就彻底失效。
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,vue}"]；写成["./src/**/*"]插件扫不到任何文件，类名索引为空 - 配置里不能有运行时报错：比如
require('missing-package')、fs.readFileSync('not-exist.txt')，一出错就退回到默认主题，theme.extend全部消失
editor.quickSuggestions.strings 必须手动打开
Tailwind 类名几乎都写在字符串里：className="text-lg bg-blue-500"。而 VSCode 默认关闭字符串内的自动提示——这是最隐蔽、最高频的“没提示”原因，90% 的人卡在这一步。
- 打开设置（
Ctrl+,或Cmd+,），搜editor.quickSuggestions，展开后把strings设为true - 改完不用重启 VSCode，但得重新打开当前文件，或执行命令
Developer: Reload Window - 这个开关影响所有字符串补全（比如 JSON 键名、正则字面量），关掉它，连
{"key": ""}里输key都不提示
语言模式不对或 classRegex 没配，JSX/TSX 里 className/cn() 就不生效
插件默认只在 html、typescriptreact、vue 等语言模式下激活。你在 .tsx 文件里写 className，但右下角显示的是 TypeScript 或 Plain Text，补全压根不会触发。
立即学习“前端免费学习笔记（深入）”；
- 点击右下角语言标识，手动切到
TypeScript React（React 项目）或VUE（Vue 项目） - 对非标后缀（如
.page.tsx），在settings.json加映射："files.associations": {"*.page.tsx": "typescriptreact"} - 用了
cn()、tw()或模板字面量（如tw`text-lg`），就得配classRegex："tailwindCSS.experimental.classRegex": [ "className\s*=\s*['"`]([^'"`]*)['"`]", "class\s*=\s*['"`]([^'"`]*)['"`]", "cn\s*\(\s*(['"`][^'"`]*?['"`])" ]
注意：正则里的括号和引号必须双反斜杠转义
动态类名（如 className={`bg-${color}-500`}）天然不支持补全——这不是配置问题，是静态分析的硬限制；classRegex 只能提取字符串字面量，变量插值部分无法推断。
