Tailwind CSS原子类无效的根本原因是构建系统未生成对应CSS规则。常见原因包括：CDN版默认禁用变体、content路径遗漏导致类名未扫描、@tailwind指令缺失或错误、动态拼接类名未进safelist、任意值语法未被静态分析到。
Tailwind CSS 的原子化样式不是“引入就能用”，而是必须让构建系统识别并生成对应 CSS 规则——没走通这一步，text-blue-500、flex-col 这些类名在浏览器里永远是无效的。
为什么直接写 class="bg-red-500" 却没效果？
最常见原因是 Tailwind 的 CSS 并未真正注入到页面中。CDN 方式（<script src="https://cdn.tailwindcss.com"></script>）虽快，但默认只启用基础类，hover:underline、md:flex、dark:bg-gray-800 等变体全被跳过，查元素面板也看不到对应规则。
真正可靠的引入路径只有构建时集成：
- 确保
tailwind.config.js的content字段明确列出所有含 class 的文件，比如"./src/**/*.{js,jsx,ts,tsx,vue}"，漏掉路径 = 对应类名不会生成 - CSS 入口文件（如
index.css）里必须有且仅有三行：@tailwind base;、@tailwind components;、@tailwind utilities;，少一行或拼错大小写都会中断生成 - Vite 项目需安装并启用
@tailwindcss/vite插件；Create React App 则必须用craco或react-app-rewired绕过默认配置限制
md:text-lg 在中等屏不生效？检查断点与基础类是否共存
Tailwind 的响应式前缀（md:、lg:）不是独立规则，它只是给已有类加媒体查询包裹。这意味着：md:text-lg 生效的前提是元素本身已声明 text-lg 或其他文本尺寸类——否则媒体查询无载体可绑。
立即学习“前端免费学习笔记（深入）”；
更隐蔽的问题是断点值误判：
- 默认
md断点是768px，但如果你在tailwind.config.js里改过screens，比如设成md: '800px'，而浏览器宽度卡在790px，那md:类就完全不触发 -
md:hidden lg:block在768–1023px区间会隐藏，但很多人以为 “lg 覆盖 md”，其实它们是并行条件，中间没有 fallback - 用浏览器 DevTools 的 “Rendering” 面板开启 “Emulate CSS media features”，手动切到
md尺寸，看实际匹配的媒体查询是否符合预期
动态拼接类名（如 class={\`p-\${size} text-\${color}\`}）为何失效？
JIT 编译器（v3.0+ 默认启用）只分析静态字符串，text-\${color} 这种模板字面量会被忽略，对应 CSS 规则根本不会生成——运行时 class 存在，但浏览器查不到样式定义。
安全方案只有两个：
- 预设所有可能值，在
tailwind.config.js的theme.extend.spacing或colors里显式声明，比如加入'6': '1.5rem'，然后固定用p-6 - 改用
clsx或twMerge拼接**已存在**的类名组合，例如clsx('p-4', color === 'red' ? 'text-red-500' : 'text-blue-500') - 绝对避免
text-[#1e3a8a]这类任意值语法用于动态场景，它只对 JIT 能扫描到的字面量有效
真正卡住多数人的从来不是类名记不住，而是构建链路某处静默失败：config 路径写错、PostCSS 插件没加载、Vite 的 CSS 处理被其他插件拦截——遇到样式不生效，第一反应不该是查文档，而是打开浏览器开发者工具的 Network 面板，确认 index.css 是否返回 200 且内容里真有 .text-blue-500 的规则。
