根本原因是插件未加载配置或未识别语言模式：需安装bradlc官方插件、确保tailwind.config.js在根目录并用module.exports导出、content路径显式含扩展名、开启editor.quickSuggestions.strings、为clsx/tw等函数配置classRegex。
装了 tailwindcss-intellisense 却没提示，不是插件坏了，而是它根本没加载你的配置、或压根没识别你在写 Tailwind —— 这是 90% 的“不提示”问题根源。
确认插件是 bradlc 官方版且无冲突
VS Code 扩展市场里搜 tailwindcss-intellisense，必须认准发布者是 bradlc（Tailwind Labs 官方授权）。其他名字带 “tailwind”“autocomplete”“class”的插件，基本不维护、不支持 @apply 或 theme()，还可能和你本地配置冲突。
- 插件 ID 是
bradlc.vscode-tailwindcss，可在扩展详情页确认 - 装完立刻禁用所有其它 Tailwind 相关插件（比如
Auto Rename Tag附带的类名补全） - 别信“一键启用”类教程——它不自动生效，依赖项目配置和语言模式对齐
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 默认关闭字符串内的自动补全，这是最隐蔽也最高频的“没提示”原因。
立即学习“前端免费学习笔记（深入）”；
- 打开设置，搜
editor.quickSuggestions，展开后把strings设为true - 改完不用重启，但得重新打开当前文件，或执行命令
Developer: Reload Window - 这个设置影响所有字符串提示，不只是 Tailwind；关掉它，连 JSON 字符串里的 key 都不提示
动态类名（如 bg-${color}-500）永远不补全
这不是配置问题，是设计限制。插件靠静态分析 content 路径下的文本内容生成候选类名列表，变量插值、模板拼接、运行时计算的结果无法被提前预知。
-
clsx()、twMerge()、cn()等函数需要额外配置："tailwindCSS.experimental.classRegex": ["clsx\(([^)]*)\)"] -
tw`text-${size}-font`这类模板字面量需配："tailwindCSS.experimental.templateStringRegex": "tw`([^`]*)`" - 复杂逻辑建议抽到
computed或保持 class 属性为静态字符串，避免过度依赖插件解析能力
真正卡住人的地方，往往不是配置写错，而是插件加载失败时完全不报错——它就安静地退回默认主题，让你以为“只是没提示”，其实连你写的 brand 颜色都根本没读进去。
