backdrop-blur-sm无效需查三件事：Tailwind版本≥3.1、tailwind.config.js中显式配置theme.extend.backdropBlur、清缓存重构建；还需确保遮罩有半透背景、背后有真实内容、无overflow:hidden截断，Safari需加-webkit前缀。
backdrop-filter 能让遮罩真正“透出背景并模糊”，但直接写 backdrop-blur-sm 大概率无效——它不是开箱即用的类，而是需要配置、搭配和兜底的组合技。
backdrop-blur 类名写了却没效果？先查三件事
不是你漏了 class，是 Tailwind 根本没生成对应 CSS 规则：
- 运行
npm list tailwindcss，确认版本 ≥ 3.1；v3.0 及更早版本完全不识别backdrop-blur-* - 检查
tailwind.config.js的theme.extend.backdropBlur是否显式声明，例如：{ sm: '4px', md: '8px' }；只写 class 不配置，构建后 CSS 里搜不到backdrop-filter: blur(4px) - 清缓存重构建：Vite 用户重启 dev server，Next.js 用户跑
next dev，或手动执行npx tailwindcss -i ./src/input.css -o ./dist/output.css --watch
遮罩背后“糊了个寂寞”？检查渲染上下文是否被截断
backdrop-filter 模糊的是元素「背后的内容」，不是它自己。背后若为空白、被遮住或被裁剪，滤镜就失效：
- 遮罩自身必须有带 alpha 的背景色，如
bg-white/10或bg-black/20；bg-transparent或bg-white opacity-20都不行 - 父容器不能设
overflow: hidden或clip-path，否则 backdrop 采样区域被裁掉，边缘模糊消失甚至整块变灰 - 遮罩应挂载到
document.body直接子级（比如用createPortal），避免被祖先的transform、filter或isolation: isolate切断层叠上下文
Safari 和旧版 Chrome 显示空白？缺 -webkit-backdrop-filter
Tailwind 默认只输出标准 backdrop-filter，但 Safari ≤16.6、部分 macOS Chrome 仍依赖前缀版本，且控制台零报错：
立即学习“前端免费学习笔记（深入）”；
- 不要指望
backdrop-blur-sm自动带上-webkit-；它不会 - 推荐用
@layer utilities封装自定义类，同时写明两套值：-webkit-backdrop-filter: blur(4px)必须与backdrop-blur-sm对应（默认 4px），否则 Safari 会回退为无模糊 - 可加
backdrop-saturate-150提升色彩通透感，这是纯视觉增益点，不影响兼容性
Firefox 用户看到的是普通半透明遮罩？必须提供降级方案
Firefox 当前（2026 年中）仍默认禁用 backdrop-filter（需用户手动开启 layout.css.backdrop-filter.enabled），且无法用 JS 安全检测：
- 用
@supports (backdrop-filter: blur(1px))包裹毛玻璃样式，确保基础层（如bg-white/5 border border-white/10）始终生效 - 避免在
overflow-y-auto容器内对整个滚动区应用backdrop-filter；只作用于固定定位的遮罩层（如弹窗 wrapper） - 模糊值别超过
backdrop-blur-md（8px）；实测在中低端 Android 和 Safari 上，≥12px 易掉帧，尤其配合滚动时
真正容易被忽略的，是 backdrop-filter 的“采样依赖性”——它不报错、不警告，只安静地糊空气。调试时别只看 class 写没写对，要打开 DevTools 的 Layers 面板，确认模糊层是否真在合成时拿到了背后的像素。
