Tailwind类名不生效的首要原因是class属性拼写错误，如写成clas或calss导致浏览器忽略整个属性；其次为类名本身拼错，包括大小写错误、连字符缺失（如bg-blue500）、数字超范围（如bg-blue-1000）等。
Tailwind 类名拼写错误几乎总是导致样式“消失”的第一原因，而不是配置或构建问题。它不报错、不警告，只默默失效——你得自己发现。
class 属性名写成 clas 或 calss 就全失效
这是最隐蔽也最常犯的错误：HTML 中把 class 属性名拼错，比如写成 clas、calss、className（在纯 HTML 中无效）等。浏览器直接忽略整个属性，所有类名都不解析。
- 现象：元素上明明写了
bg-blue-500 text-center，但背景和文字都无变化；开发者工具里 DOM 节点根本看不到class属性 - 验证方式：右键检查元素 → 切到 Elements 面板，确认该标签是否真有
class="..."属性 - 注意：Vue/React 模板中用
class是对的；JSX 里必须用className，但那是 React 的规则，不是 Tailwind 的问题
类名本身拼错：大小写、连字符、数字缺位
Tailwind 类名是严格小写 + 连字符分隔的字符串，任何偏差都会让 JIT 引擎找不到对应规则。
-
bg-blue500❌（缺连字符）→ 正确是bg-blue-500 -
textBlue-600❌（驼峰）→ 正确是text-blue-600 -
bg-rose900❌（连字符缺失）→ 正确是bg-rose-900 -
bg-blue-1000❌（超出范围）→ Tailwind 默认只生成50–900 -
from-cyan-400 to-cyan-700✅（两个独立类）≠from-cyan-400-to-cyan-700❌（一个非法类）
安装 Tailwind CSS IntelliSense 后仍不提示？检查这三点
VS Code 插件不是装完就自动生效的，尤其在多根工作区或非标准项目结构下容易静默失败。
立即学习“前端免费学习笔记（深入）”；
- 确认插件已启用：打开 VS Code 设置 → 搜索
tailwind css intellisense→ 确保状态为 Enabled - 检查工作区是否识别为 Tailwind 项目：插件依赖
tailwind.config.js或tailwind.config.ts文件存在且可读；若配置在子目录（如packages/ui/tailwind.config.js），需在插件设置里手动指定tailwindCSS.includeLanguages和tailwindCSS.files - 重启语言服务器：命令面板（
Ctrl+Shift+P）→ 输入Developer: Restart Language Server→ 回车；或者关闭再重开文件夹
快速验证类名是否被 Tailwind 扫描到
不用跑构建、不用开 DevTools，一行命令就能确认。
- 运行
npx tailwindcss -i ./src/input.css -o ./dist/output.css --minify --watch并观察终端输出：如果类名拼错，它不会报错，但也不会生成对应 CSS 规则 - 更直接的方式：在任意
.css文件里写@layer utilities { .debug-test { color: red; } }，然后在 HTML 中用class="debug-test"—— 如果这个生效但text-red-500不生效，基本锁定是类名拼写或配置问题 - 终极兜底：打开浏览器控制台，输入
tailwind.config，看是否返回配置对象；若报ReferenceError，说明 CDN 或构建未加载成功，和拼写无关
拼写错误本身没技术深度，但排查时最容易卡在「以为是配置问题」上。盯住 class 属性名和每个类名的连字符、数字、大小写，比调 tailwind.config.js 有效十倍。
