VSCode中Tailwind类名无提示的主因是插件未读取配置、未识别语言模式或字符串补全关闭；需确保tailwind.config.js在根目录且module.exports导出、content路径显式含扩展名、editor.quickSuggestions.strings设为true，并确认右下角显示Tailwind CSS图标。
VSCode 里 Tailwind 类名没提示，90% 不是插件坏了，而是它压根没读到你的 tailwind.config.js、没认出你在写 JSX、或者连字符串补全都关着——这三处卡住，补全就彻底静默。
右下角没显示 Tailwind CSS 图标？配置根本没加载
插件只读取工作区根目录（即你执行 code . 打开的那一层）下的 tailwind.config.js 或 tailwind.config.cjs。路径错、导出错、语法错，都会导致静默降级为默认主题，你自定义的 theme.extend.colors.brand 就不会出现。
-
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,vue}"]；写成["./src/**/*"]插件无法匹配，索引为空 - 配置里不能有
require('missing-package')、fs.readFileSync('nonexistent.txt')或await—— 插件加载阶段不支持这些，失败也不报错
写了 className="" 却没提示？语言模式或字符串补全关了
Tailwind 补全只在特定语言模式下激活：默认支持 html、typescriptreact、vue 等。你在 .page.tsx 里写 className=""，但右下角显示的是 Plain Text 或 TypeScript，补全压根不会触发。
- 点击右下角语言标识，手动选成
TypeScript React（React 项目）或VUE（Vue 项目） - 对非标后缀，在
settings.json加映射："files.associations": {"*.page.tsx": "typescriptreact"} - 必须开启字符串内补全：
editor.quickSuggestions.strings设为true；这是最常被忽略的开关，关掉它连 JSON 字符串里的 key 都不提示 - 改完不用重启 VSCode，但需关闭再重新打开当前文件，或执行命令
Developer: Reload Window
class 里提示乱码、只显示基础类名？content 没扫到你写的文件
IntelliSense 不是靠猜，是靠扫描 content 列出的路径下所有字符串字面量。路径写错、通配符漏掉、文件类型没列全，就搜不到类名。
立即学习“前端免费学习笔记（深入）”；
-
content是相对项目根目录的，不是相对于配置文件；写../src很可能失效 - React 项目要确保包含
.tsx和.jsx；Vue 项目必须加.vue；纯 HTML 文件也得加.html，否则不索引 - 动态类名如
class="bg-${color}-500"默认不解析；插件只处理静态字符串，比如className="text-lg bg-blue-500" - 若用了
cn()或tw()工具函数，需在settings.json中配置正则："tailwindCSS.experimental.classRegex": ["cn\(\s*(["'`][^"'`]*["'`])"]
@tailwind base 报 Unknown at rule？CSS 校验太严格
VSCode 内置 CSS 语言服务不认识 @tailwind、@apply 这类非标准指令，它只按 W3C 规范校验。这不是构建错误，只是编辑器“过度校验”。
- 打开设置，搜索
css.lint.unknownAtRules，把值从warning改成ignore；改完立刻生效 - 这个设置只屏蔽警告，不影响实际编译——只要
postcss.config.cjs和tailwind.config.cjs配对正确，样式照样能输出 - 别忘了装
Tailwind CSS IntelliSense（bradlc 发布），否则语法高亮、颜色预览、@apply补全全丢 -
postcss.config.cjs必须用 CommonJS 导出：module.exports = { plugins: { tailwindcss: {}, autoprefixer: {} } }；写成 ES module 或带引号的插件名（如"tailwindcss"）都会让插件识别失败
最容易被忽略的其实是 content 路径里的扩展名拼写和 editor.quickSuggestions.strings 的开关状态——它们不出错、不报红，但一关就整个补全链断掉，而且没有任何提示告诉你哪错了。
