Bootstrap 5 模态框显示时为防抖动给 body 添加 padding-right，fixed 元素因脱离文档流而相对右移；正确解法是为其添加 .is-fixed 类，由 scrollbar.js 自动同步补偿。
为什么 body 加了 padding-right 但 fixed 元素却右移了
bootstrap 5 在模态框显示时，会自动给 body 添加 modal-open 类，并设置 padding-right（通常是 15–17px）来补偿滚动条消失造成的宽度变化——这是防抖动的主动设计，不是 bug。但 position: fixed 元素脱离文档流，不响应 body 的 padding-right，视觉上就表现为“向右偏移”（其实是其他内容左缩，fixed 元素原地不动，相对位置变了）。
常见误操作包括：
- 手动写
body { padding-right: 0 !important }，直接破坏补偿逻辑，导致页面横向抖动重现 - 给
.navbar-fixed-top或自定义header加了fixed却没加 Bootstrap 的适配类 - 用
overflow-y: overlay或scrollbar-gutter等现代方案后，仍保留旧版补偿逻辑，造成冗余偏移
给 fixed 元素加 .is-fixed 类是最稳妥的解法
Bootstrap 5 内置了对固定定位元素的动态补偿支持，前提是显式标记。只要在对应元素上加上 .is-fixed，它就会在 modal-open 生效时，被内部的 scrollbar.js 自动同步添加/移除 padding-right，无需额外 JS 或 CSS。
示例写法：
<header class="fixed-top bg-white is-fixed">...</header><div class="hero-bg is-fixed" style="background-image: url(...) "></div>
注意：
-
.is-fixed是纯语义类，本身无样式，不会影响非 modal 场景 - 它只对
fixed-top、fixed-bottom、sticky-top和带.is-fixed的元素生效 - 如果用了第三方滚动库（如
overlay-scrollbars），需确认其是否劫持了document.body.offsetWidth计算，否则 Bootstrap 可能误判滚动条宽度为 0，导致补偿失效
data-bs-backdrop="static" 能跳过 padding 补偿，但有副作用
在模态框根元素上加 data-bs-backdrop="static"，可让 Bootstrap 完全跳过 padding-right 注入和 overflow: hidden 设置——适合滚动条已用 scrollbar-gutter: stable 或始终存在留白的现代布局。
但它同时禁用点击 backdrop 关闭模态框，且可能让背景内容意外可滚动（尤其在快速连续打开多个 modal 时）。若业务允许，更推荐：
- 全局配置：在 Bootstrap 初始化前覆盖
Bootstrap.Modal.Default.backdrop = 'static' - 局部控制：仅对不需要背景锁定的 modal 使用该属性，比如轻量提示类弹窗
- 别混用：不要一边设
data-bs-backdrop="static"，一边又手动监听shown.bs.modal去调scrollTop，容易触发 layout thrashing
手写 show/hide 逻辑时，必须同步处理 modal-open 和 padding-right
绕过 bootstrap.Modal.getInstance(el).show() 或 $(el).modal('show')，直接操作 class 或 style，会导致滚动锁定完全失效。此时要自己补全逻辑：
- 显示前：用
document.body.classList.add('modal-open')+ 动态测滚动条宽度（document.body.offsetWidth - document.documentElement.clientWidth）并设document.body.style.paddingRight - 隐藏后：务必在
hidden.bs.modal中清除modal-open并还原paddingRight，否则后续页面滚动异常 - 避免在
show.bs.modal阶段就读取offsetHeight或getBoundingClientRect()，这会强制浏览器同步重排，放大抖动感
最复杂的地方往往不在 modal 本身，而在 fixed 元素是否被正确归类、第三方滚动插件是否干扰了宽度探测、以及事件钩子中是否无意触发了强制同步布局。这些点漏掉一个，抖动就还会回来。
