遮罩层不跟随滚动的解决方法是将其直接挂载到body下并设position:fixed，z-index:1040，避免父容器overflow:hidden或transform创建新层叠上下文，同时确保pointer-events:auto可点击关闭。
侧边栏展开时遮罩层不跟随滚动怎么办
遮罩层 .sidebar-backdrop 默认用 position: fixed 是对的，但若侧边栏本身用了 position: absolute 或父容器有 overflow: hidden，遮罩可能被裁剪或错位。关键是确保遮罩层直接挂载在 下，且 z-index 高于侧边栏但低于模态框（推荐 z-index: 1040，和 Bootstrap 的 .modal-backdrop 同级）。
- 用 JavaScript 动态插入遮罩：
document.body.insertAdjacentHTML('beforeend', '<div class="sidebar-backdrop"></div>') - CSS 必须写死：
.sidebar-backdrop { position: fixed; top: 0; left: 0; width: 100vw; height: 100vh; background: rgba(0,0,0,0.5); z-index: 1040; } - 避免在侧边栏容器上设
transform或will-change，否则会创建新的层叠上下文，压住遮罩
Bootstrap 5 中如何触发侧边栏 + 遮罩联动
原生 Bootstrap 没有侧边栏组件，得自己组合 offcanvas 或手写。推荐用 offcanvas —— 它自带 backdrop，只需开启 data-bs-backdrop="true" 并确保没被覆盖。
- 启用遮罩：
<div class="offcanvas offcanvas-start" data-bs-backdrop="true" data-bs-keyboard="true"> <li>禁用点击遮罩关闭：删掉 <code>data-bs-backdrop或设为"static"，再手动绑定click事件控制显隐 - 响应式断点要一致：侧边栏用
offcanvas-lg，遮罩的显示/隐藏逻辑也得在lg断点后移除，否则小屏展开时大屏遮罩还残留 - 别给遮罩加
box-shadow，它本就不该有；要增强压迫感，把rgba(0,0,0,0.5)提到0.65，但别超0.7，否则文字看不清 - 让遮罩入场更自然：加
transition: opacity 0.2s ease-in-out，并在 JS 中切换前先设opacity: 0，再offsetWidth强制重排，最后加opacity: 1 - 移动端注意：iOS Safari 对
fixed+vh计算不准，用height: -webkit-fill-available兜底 - 遮罩本就不该“贴合”侧边栏，它的作用是阻断背景交互，只需覆盖整个可视区
- 如果发现遮罩下漏出可点击区域，检查是否侧边栏设置了
margin-left而非transform: translateX()，前者会让 body 宽度变窄，遮罩仍按原始 viewport 渲染 - 极端情况（比如侧边栏高度超过视口），无需处理——用户滚动时遮罩已固定，交互阻断依然有效
阴影太浅或边缘发虚怎么调
遮罩的“阴影感”其实来自半透明黑色背景，不是 box-shadow。所谓“阴影”是视觉错觉——真正影响观感的是 background 的 alpha 值和过渡动画。
侧边栏宽度变化时遮罩没重绘
当侧边栏内容动态加载、高度撑开，或从 collapsed 切换到 expanded 状态时，遮罩不会自动适配新尺寸——因为它只占满视口，和侧边栏尺寸无关。这不是 bug，是设计使然。
最易被忽略的点：遮罩的 pointer-events: auto 必须保留，否则点击它无法触发关闭逻辑；很多人为了“让背后元素不可点”误设成 none，结果遮罩自己也点不动了。
