Tailwind CSS IntelliSense 无提示的主因是配置未被识别或语言模式不匹配：需安装官方 bradlc 插件、确保 tailwind.config.js 在项目根目录且正确导出、显式配置 content 路径、开启字符串补全、校准文件语言模式为 HTML/TypeScript React，并仅在 class/className 属性中触发补全。
装了 tailwindcss-intellisense 却没提示？不是插件坏了，而是它根本没加载你的配置或没识别到当前文件类型——这是 90% 的“不工作”问题根源。
确认安装的是官方 bradlc 插件
VS Code 扩展市场里搜 tailwindcss-intellisense，必须认准发布者是 bradlc（Tailwind Labs 官方授权）。其他名字带 “tailwind”“autocomplete”“class”的插件，基本不维护、不支持 @apply 嵌套或 theme() 函数，还可能和你本地配置冲突。
- 插件 ID 是
bradlc.vscode-tailwindcss，可在扩展详情页确认 - 装完立刻禁用所有其它 Tailwind 相关插件，避免补全重复或覆盖
- 别信“一键启用”类教程——它不自动生效，依赖项目配置和语言模式对齐
确保 tailwind.config.js 被正确读取
插件只读取 VS Code 当前工作区根目录（即你执行 code . 打开的那一层）下的 tailwind.config.js 或 tailwind.config.cjs。路径错、语法错、导出错，都会导致静默降级为默认配置。
-
tailwind.config.js必须在项目根目录，不能放在src/或config/下；若真放子目录，得在.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-pkg')、fs.readFileSync('nonexistent.txt')，或await——插件加载失败时不会报错，只会默默退回到默认主题
打开字符串补全并校准语言模式
Tailwind 类名几乎都写在字符串里：className="text-lg bg-blue-500"。而 VS Code 默认关闭字符串内的自动补全，这是最隐蔽也最高频的“没提示”原因。
立即学习“前端免费学习笔记（深入）”；
- 打开设置（
Ctrl+,），搜索editor.quickSuggestions，点开后把strings设为true - 改完不用重启 VS Code，但需重新打开当前文件，或执行命令
Developer: Reload Window - 右下角状态栏必须显示
HTML、TypeScript React或JavaScript React；若显示Plain Text或TypeScript，点击切换为对应语言模式 - TSX 文件需在
settings.json中加映射："files.associations": {"*.tsx": "typescriptreact"} -
tailwindCSS.includeLanguages应包含：{"typescriptreact": "html"}，否则 JSX 中的className不触发补全
验证补全是否真正生效
补全只在明确标记为 class 属性的位置激活，不是所有字符串都能触发——这是设计限制，不是 bug。
- ✅
<div class="text-"> - ✅
<button className="bg-">（React JSX） - ✅
<template><div class="p-"></div></template>（Vue SFC） - ❌
const cls = "text-";（JS 变量赋值） - ❌
className={someVar + " text-"};（JSX 表达式中拼接） - ❌
<style>.text-lg { }</style>（CSS 块内）
动态拼接的类名如 className={`bg-${color}-500`} 永远不补全，这是静态分析的天然边界。想让自定义颜色 theme.extend.colors.brand 出现在提示里，除了配置正确，还得确保至少一个被 content 扫到的文件里实际写了 text-brand-500（哪怕只是注释）。
