backdrop-blur无效需三步排查：确认Tailwind≥3.1版本、在config中扩展backdropBlur映射、清缓存重构建；确保元素有半透背景、父容器无overflow:hidden、背后有真实内容；Safari需加-webkit-backdrop-filter前缀。
backdrop-blur 类名写了却没效果？不是你写错了，是 Tailwind 根本没生成那行 CSS —— 这是最常见的卡点，先确认版本和配置再调样式。
backdrop-blur-md 为什么完全不生效
Tailwind v3.0 及更早版本压根不识别 backdrop-blur-md；v3.1+ 虽声明支持，但默认配置里不生成对应规则，类名会被静默忽略。
- 运行
npm list tailwindcss，确认输出版本 ≥3.1.0 - 打开
tailwind.config.js，在theme.extend中补全backdropBlur映射（值必须是字符串，如'md': '8px'） - 清缓存并重构建：Vite 用户重启 dev server；Next.js 用户运行
next dev；或手动执行npx tailwindcss -i ./src/input.css -o ./dist/output.css --watch - 打开最终生成的 CSS 文件（如
dist/output.css），搜索backdrop-filter: blur(8px)—— 没搜到就说明配置失败，别往下调试透明度或层级
元素有 backdrop-blur 却还是纯色块
backdrop-blur 模糊的是元素「背后的内容」，不是它自己。背后空、前面不透、父容器裁剪，三者任一成立，效果就失效。
- 元素自身必须带透明背景：
bg-white/10、bg-black/20可用；bg-white或bg-gray-50（无 alpha）直接白搭 - 父容器不能设
overflow: hidden：它会裁掉 backdrop 的采样区域，导致边缘模糊缺失甚至整块变灰白 - 背后必须真有内容层：模态框建议挂载到
document.body直接子级；侧边栏若嵌在z-index: 0的 wrapper 里，就可能被挡住视觉层级
Safari 和旧版 Chrome 里毛玻璃消失
Tailwind 默认只输出标准 backdrop-filter，但 Safari ≤16.6、部分 macOS Chrome 仍依赖 -webkit-backdrop-filter。不加前缀，效果完全不可见，且控制台不报错。
立即学习“前端免费学习笔记（深入）”；
- 最稳妥做法是定义自定义工具类，同时覆盖标准属性与 WebKit 前缀：
- 在
@layer utilities中写：
.glass {
@apply bg-white/10 backdrop-blur-sm backdrop-saturate-150;
-webkit-backdrop-filter: blur(4px) saturate(1.5);
}
backdrop-blur-sm（对应 4px）对齐，否则 Safari 会显示未模糊的原始背景backdrop-blur-sm 和手写的 style="backdrop-filter: blur(4px) brightness(1.2)"，后者会覆盖前者模糊值怎么选才不翻车
Tailwind 预设档位太粗（backdrop-blur-sm = 4px），高分屏上基本看不出效果；而盲目拉大值又容易触发性能问题。
- 移动端优先用
backdrop-blur-md（8px）或backdrop-blur-lg（12px）；桌面端可试探backdrop-blur-xl（16px），但务必真机测 - iOS Safari 对 >12px 渲染明显变慢，滚动中卡顿感强；安卓 WebView 多数只支持 ≤12px
- 想微调？在
tailwind.config.js里加'2xl': '20px'，然后用backdrop-blur-2xl—— 不用手动写任意值，也避免 JIT 漏编译 - 别迷信
-xl以上：超过 24px 后，低端设备渲染延迟显著，且边缘易出现灰白噪点
真正难的不是写类名，而是让浏览器“看见”背后的内容——这需要你同时控制好透明度、层级、容器溢出行为和兼容性前缀。漏掉任一环，毛玻璃就退化成一块半透明板子。
