抽屉侧边栏必须用 transform 而非 left 或 margin-left，因其仅触发重绘或合成层提升，配合 GPU 加速更顺滑；需加 will-change: transform、避免 overflow: hidden 截断、禁用 body overflow 锁定。
抽屉侧边栏为什么必须用 transform 而不是 left 或 margin-left
用 left 或 margin-left 移动侧边栏会触发重排（reflow），动画卡顿明显，尤其在低端 Android 设备上几乎不可用；transform: translateX() 仅触发重绘（repaint）甚至合成层提升，配合 GPU 加速，滑动顺滑得多。iOS Safari 对 transform 的优化也更成熟，这是实际跑过真机后确认的底线选择。
关键点：
- 必须给抽屉容器添加 will-change: transform（或 transform: translateZ(0)）来主动提示浏览器启用合成层
- 抽屉内容区域（如 .sidebar-content）不能设 overflow: hidden 在父容器上，否则 iOS Safari 会截断过渡中的元素
- 不要对 body 加 overflow: hidden 来锁滚动——这会导致 Safari 地址栏不收起、页面回弹异常；改用 position: fixed + top: 0 锁定主内容区高度
transition 的时长和缓动怎么配才不“手机感”
移动端抽屉动画不是越快越好。太快（如 0.2s）显得生硬，太慢（0.5s）又拖沓。实测最自然的是 0.35s cubic-bezier(0.34, 1.56, 0.64, 1) —— 这个贝塞尔曲线前段稍缓、后段有轻微“惯性回弹”，模拟了 iOS 原生抽屉的手感。
注意两个细节：
- 主内容区（.main）和侧边栏（.sidebar）的 transition 必须完全一致，否则视觉错位
- 切换状态时，先更新 class，再读取 getBoundingClientRect() 或触发重排，否则 Safari 可能跳过首帧动画
- 避免在 transition 中混用 transform 和 opacity：安卓 WebView 对多属性过渡支持不稳定，建议分开控制（例如 opacity 单独加 class，不参与同一 transition）
如何用纯 CSS 实现“点击遮罩层关闭”且不干扰手势滑动
遮罩层（.overlay）必须存在，但它的点击关闭逻辑不能靠 JS 绑定 click——移动端 click 有 300ms 延迟，且和 touchmove 冲突。正确做法是：
- 遮罩层始终存在，初始 opacity: 0; pointer-events: none;
- 抽屉展开时，同时加 class 让它 opacity: 0.5; pointer-events: auto;
- 关键：遮罩层 z-index 必须严格介于主内容和侧边栏之间（如主内容 z: 1，遮罩 z: 10，侧边栏 z: 11），否则 iOS 上 touchstart 可能穿透到下层
- 不监听遮罩的 click，而是监听 touchend 并判断 target === overlay，立刻移除 active class —— 这样无延迟，且不会拦截侧边栏内部的滑动操作
真机调试时最常踩的三个坑
这三个问题在 Chrome DevTools 模拟器里完全看不出来，只有连真机调试才会暴露：
- iOS Safari 下，transform: translateX(-100%) 如果侧边栏宽度是百分比或 vw，可能因视口缩放导致偏移量不准，固定用 transform: translateX(-300px)（配合 max-width: 300px）更稳
- 安卓部分厂商浏览器（如华为 EMUI 内置浏览器）不支持 transform 动画中动态修改 width，所以侧边栏宽度必须写死或用 flex-basis，别用 width: 80% + transform 组合
- 手势滑动关闭时，如果主内容区有 input 获焦，键盘弹出会强制重绘，导致动画中断。解决方案：抽屉打开期间，给 input 加 disabled 属性（视觉可保留样式），或用 pointer-events: none 暂时禁用输入
侧边栏动画的复杂度不在实现，而在各种设备渲染管线的差异。你调通了一个机型，不代表其他机型没问题——务必在 iOS 15+、Android 12+ 三星/小米/华为主力机型上实测滑动跟手度和关闭响应速度。
