backdrop-blur 无效需先确认 Tailwind ≥3.1 并在 config 中启用 backdropBlur；侧边栏需半透明背景（如 bg-white/10）、父容器无 overflow:hidden，且背后有可模糊内容；iOS 和微信需兼容处理。
backdrop-blur 类名写了却没模糊效果？先确认 Tailwind 版本和配置
Tailwind v3.0 不支持 backdrop-blur，必须 ≥ 3.1 才行。即使版本够，也得在 tailwind.config.js 里显式启用——默认不生成对应 CSS，写了也白写。
检查方法：打开构建后的 CSS 文件（比如 dist/output.css），搜索 backdrop-filter 或 backdrop-blur，有结果才说明配置生效。
- 没搜到？补上
theme.extend.backdropBlur配置，值必须是带单位的字符串，如'8px'，不能写8 - 升级后仍无效？清缓存、重运行构建命令，比如
npx tailwindcss -i ./src/input.css -o ./dist/output.css --watch - 用的是旧项目且卡在 v2.x？必须升级，v2 和 v3.0 都不认
backdrop-blur
侧边栏加了 backdrop-blur 还是纯色块？大概率背景不“透”
backdrop-blur 模糊的是元素「背后」的内容，不是它自己。如果侧边栏是 bg-white 或 bg-gray-800 这类不透明色，后面再模糊也看不见。
- 必须搭配半透明背景：用
bg-white/10、bg-black/20这种新语法，别用已废弃的bg-opacity - 父容器不能设
overflow: hidden，否则裁掉 backdrop 区域，模糊直接失效 - 确保侧边栏真有“背后内容”：比如它应该放在
body直接子级，别被某个z-index: 0的 wrapper 挡住层级 - iOS Safari 对 >12px 模糊渲染偏慢，侧边栏建议优先用
backdrop-blur-md（8px）或backdrop-blur-lg（12px）
想微调毛玻璃质感？别只靠 backdrop-blur
单靠模糊容易发灰或边缘生硬，真实毛玻璃需要组合控制：饱和度、边框、圆角、阴影。Tailwind 默认不提供 backdrop-saturate，得手动扩展或内联写。
立即学习“前端免费学习笔记（深入）”；
- 推荐加
-webkit-backdrop-filter兼容旧版 Safari（≤16.6）和部分 macOS Chrome - 边框用
border border-white/15+border-opacity-20软化边缘，比纯透明更稳 - 深色模式下，
bg-white/10在暗背景下会过亮，改用dark:bg-gray-900/30更协调 - 微信内置浏览器（X5 内核）完全不支持
backdrop-filter，要降级 fallback，比如用bg-black/5+blur-sm（作用于自身）模拟近似感
为什么侧边栏滚动时模糊突然消失或卡顿？
这不是代码错，是渲染上下文被破坏。常见触发点：transform、opacity
- 避免给侧边栏加
transform: translateX(0)或opacity-95这类属性 - 滚动容器别设
overflow: hidden，改用mask或伪元素绕过裁剪 - 动画中同步触发
backdrop-blur和opacity易掉帧，iOS Safari 尤其明显；可改用transition: backdrop-filter 300ms ease单独控制 - 高模糊值（如
backdrop-blur-2xl）在低端安卓 WebView 上可能渲染成黑块，加bg-black/5微调底色能缓解但无法根治
最常被忽略的一点：blur 值再大，背后要是纯白背景或空 div，出来的只是灰白边缘——毛玻璃效果必须有“源图像”可采样。侧边栏背后至少得有一层带纹理、渐变或图片的容器，否则所有配置都白搭。
