Tailwind响应式类不生效主因是content路径未覆盖含类名文件、动态插值未进safelist、容器查询插件未启用或配置错误、或配置修改后未重启开发服务器。
Tailwind 的响应式类（如 md:text-lg、lg:grid-cols-3）不生效，几乎从来不是“写错了”，而是构建阶段根本没生成对应 CSS 规则——它压根没被扫描到、没被识别为有效类名，或被其他配置静默跳过。
content 路径没覆盖真实组件文件，类名直接被丢弃
Tailwind 不运行时解析 DOM，只在构建时静态扫描源码里**字面量出现的类名**。如果 tailwind.config.js 的 content 字段没匹配到你写 md:bg-blue-500 的 .tsx 文件，那这个类连 CSS 都不会生成。
-
content: ["./src/*.js"]→ 漏掉.tsx和嵌套目录，React 组件全失效 -
content: ["../src/App.tsx"]→ glob 不支持上层相对路径，整条路径被忽略 -
content: ["./public/index.html"]→ Vite 默认不扫描public/，得手动加且确保路径存在
正确写法（React + TSX）：
content: [
"./src/**/*.{js,jsx,ts,tsx}",
"./public/index.html"
]
用 Astro 或 MDX？补上 "./src/**/*.mdx"；用 Lit？补上 "./src/**/*.ts"（模板常藏在 TS 字符串里）。
立即学习“前端免费学习笔记（深入）”；
动态类名如 md:${size}-text 或 class={\`md:\${variant}-bg\`} 必然失效
插值语法（${...}）在构建时是变量，不是字符串字面量。Tailwind 扫不到 md:sm-text 或 md:primary-bg，自然不打包。
- 高频组合提前定义对象：
const textSizes = { sm: 'md:text-sm', lg: 'md:text-lg' } - 用
safelist显式声明：safelist: ['md:text-sm', 'md:text-lg', /md:text-[a-z]+/] - 正则必须用斜杠包裹：
/md:text-[a-z]+/，写成'/md:text-[a-z]+'就是普通字符串，无效
容器查询（@container）静默不工作，不是语法错，是插件没加载
容器查询不是开箱即用的功能。漏掉任一条件，DevTools 里都看不到输出，也不报错——它只是被 PostCSS 插件跳过了。
- Tailwind 版本必须 ≥ v3.4（v4 兼容性差，RuoYi-Vue3 等项目建议锁死
tailwindcss@^3.4.0） -
tailwind.config.js根对象下必须有experimental: { containerQueries: true }，不能塞进theme或plugins里 - 必须显式安装并注册插件：
npm install -D @tailwindcss/container-queries，然后在plugins数组里require('@tailwindcss/container-queries') - 所有
@container规则（包括@container card）必须包裹在@layer utilities或@layer components内 - HTML 容器元素必须带
@container类（或你配的container工具类），不能只靠 CSS 侧定义
重启开发服务器是最容易被跳过的硬性步骤
改完 tailwind.config.js 或 postcss.config.js 后，不重启等于白改。原因很实在：
- Node.js 缓存模块，旧配置还在内存里
- Vite/Webpack 的文件监听可能没触发重载
- PostCSS 插件状态未刷新，旧 CSS 文件仍被服务返回
硬刷页面（Ctrl+F5）没用，必须停掉 npm run dev，再重新启动。顺手清下 node_modules/.vite 或 .next 目录更保险。
真正难排查的，永远不是“怎么写”，而是“为什么写了却没进最终 CSS”——路径漏了、插值用了、插件没装、服务器没重启，四者任一卡住，响应式就停在 HTML 里，出不了浏览器。
