Tailwind CSS IntelliSense 无提示的根源是配置未被正确加载或语言模式不匹配：需安装官方 bradlc 插件、确保 tailwind.config.js 在项目根目录并正确导出、开启 editor.quickSuggestions.strings、配置 classRegex 支持 clsx/cn/tw 等函数。
装了 tailwindcss-intellisense 却没提示？不是插件没起作用，而是它根本没加载你的 tailwind.config.js，或者压根没识别到你在写 HTML/JSX —— 这是 90% 的“不提示”问题根源。
插件只认官方发布者 bradlc 的那个
VSCode 扩展市场搜 tailwindcss-intellisense，必须认准发布者是 bradlc（Tailwind Labs 官方授权）。其他名字带 “tailwind”“autocomplete”“class”的插件，基本不维护、不支持 @apply 嵌套或 theme() 函数，还可能和你本地配置冲突。
- 装完立刻禁用所有其它 Tailwind 相关插件，避免补全重复或覆盖
- 插件 ID 是
bradlc.vscode-tailwindcss，可在扩展详情页确认 - 别信“一键启用”类教程——它不自动生效，依赖项目配置和语言模式对齐
tailwind.config.js 必须在项目根目录且能正常导出
插件只读取 VSCode 当前工作区根目录（即你执行 code . 打开的那一层）下的 tailwind.config.js 或 tailwind.config.cjs。路径错、语法错、导出错，都会导致静默降级为默认配置——你自定义的 theme.extend.colors.brand 就完全不会出现。
- 文件必须是
./tailwind.config.js，不能在src/或config/下；若真放子目录，得在 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-pkg')、fs.readFileSync('nonexistent.txt')，或await—— 插件加载失败时不会报错，只会默默退回到默认主题
字符串补全默认关闭，必须手动打开
Tailwind 类名几乎都写在字符串里：className="text-lg bg-blue-500"。而 VSCode 默认关闭字符串内的自动补全，这是最隐蔽也最高频的“没提示”原因。
立即学习“前端免费学习笔记（深入）”；
- 打开设置（
Ctrl+,），搜索editor.quickSuggestions，点开后把strings设为true - 改完不用重启 VSCode，但需重新打开当前文件，或执行命令
Developer: Reload Window - 这个开关影响全局所有字符串补全（比如 JSON 键名、正则字面量），关掉它，连
{"key": ""}里输key都没提示
JSX 中用 clsx/cn/tw 等函数，得靠正则告诉插件去哪提取
插件默认只识别 class="" 和 className="" 字面量。一旦你用 clsx()、cn()、tw() 包着类名，就得手动配 tailwindCSS.experimental.classRegex，否则它根本不知道该扫哪段字符串。
- 在工作区或用户
settings.json里加这段：
{
"tailwindCSS.experimental.classRegex": [
["clsx\(([^)]*)\)", "(?:'|"|`)([^']*)(?:'|"|`)"],
["cn\(([^)]*)\)", "(?:'|"|`)([^']*)(?:'|"|`)"],
["tw`([^`]*)`", "'([^']*)'"]
]
}
- 正则必须写在
tailwindCSS节点下，不是editor.suggest相关配置 - 修改后需重启 VSCode 或执行
Developer: Reload Window才生效 - 动态拼接（如
className={`bg-${color}-500`}）天然不支持补全——这不是配置问题，是静态分析的设计限制
真正卡住人的地方，往往不是插件装没装，而是 tailwind.config.js 是否被正确加载、editor.quickSuggestions.strings 是否开着、以及你写的类名是否落在插件能解析的上下文里——比如 JSX 中的 className={...} 字面量，而不是任意 JS 字符串变量。
