Tailwind类名无提示的90%原因是配置未生效：tailwind.config.js位置错误、editor.quickSuggestions.strings关闭、语言模式不匹配或content路径未显式指定扩展名。
装了插件但 class 里没提示，90% 是 tailwind.config.js 没被读到、editor.quickSuggestions.strings 关着、或文件语言模式不对——不是插件坏了，是 VSCode 没“认出”你在写 Tailwind。
tailwind.config.js 在根目录且导出合法对象
插件只读项目根目录（即你执行 code . 打开的那一层）下的 tailwind.config.js 或 tailwind.config.cjs。它不会往上找父目录，也不会钻进 src/ 里找。
-
module.exports = { content: ["./src/**/*.{js,jsx,ts,tsx,html}"] }是安全写法；export default { ... }仅在package.json有"type": "module"且 Node ≥14.18 时才有效 -
content字段必须显式带扩展名，比如["./src/**/*.{js,jsx,ts,tsx,html}"]；写成["./src/**/*"]插件无法匹配任何文件，类名索引为空 - 配置里不能有运行时报错：比如
require("missing-package")、fs.readFileSync("nonexistent")，插件会静默降级为默认配置，你自定义的theme.extend.colors全部消失
editor.quickSuggestions.strings 必须设为 true
Tailwind 类名几乎都写在字符串里：className="text-lg bg-blue-500"。VSCode 默认关闭字符串内的自动补全，这是最隐蔽也最常被忽略的开关。
- 打开设置（
Ctrl+,），搜editor.quickSuggestions，点开后把strings设为true - 改完不用重启 VSCode，但得重新打开当前文件，或执行命令
Developer: Reload Window - 这个设置影响全局所有字符串补全（比如 JSON 键名、正则字面量），关掉它，连
{"key": ""}里输key都不提示
JSX/TSX 中 className 或 cn() 不识别？配 tailwindCSS.experimental.classRegex
插件默认只识别 HTML 的 class="" 和 JSX 的 className="" 字面量。一旦你用 cn()、tw() 或其他工具函数包着类名，就得手动告诉插件“从哪儿提取字符串”。
立即学习“前端免费学习笔记（深入）”；
- 在工作区或用户
settings.json里加这段：
{
"tailwindCSS.experimental.classRegex": [
"className\s*=\s*["'`]([^"'`]*)["'`]",
"class\s*=\s*["'`]([^"'`]*)["'`]",
"cn\s*\(\s*(["'`][^"'`]*["'`])"
]
}
tailwindCSS 节点下，不是 editor.suggest 相关设置className={`${base} ${active ? 'text-blue' : ''}`} 这种只解析静态部分，变量插值天然不补全语言模式必须是 html / typescriptreact / vue 等
插件默认只在 html、typescriptreact、vue、astro 等语言模式下激活。如果你在 .tsx 文件里写 className，但右下角显示的是 Plain Text 或 TypeScript，补全就压根不触发。
- 点右下角语言模式，手动切到
TypeScript React（React 项目）或HTML（纯 HTML） - 对非标后缀（如
.page.tsx），加映射："files.associations": {"*.page.tsx": "typescriptreact"} - 插件本身不支持纯 CSS 文件里的类名补全（
@apply除外），别在style.css里期待它提示bg-red-500
动态类名（bg-${color}-500、text-${size}-font）永远不补全，这不是配置问题，是设计限制——插件靠静态扫描 content 路径下的文本生成候选列表，运行时拼接的结果无法预知。别在这上面调配置，它本来就不该有提示。
