Bootstrap 5+ 主动添加 padding-right 是为补偿滚动条消失导致的布局偏移：模态框打开时，body 添加 modal-open 类并注入动态 padding-right（如17px），防止内容横向抖动；但 fixed 元素未同步补偿，故视觉上“向左一缩”，需加 .is-fixed 类或使用 data-bs-backdrop="static" 安全禁用。
为什么 modal-open 会加 padding-right？
这是 Bootstrap 5+ 主动做的滚动条宽度补偿：模态框弹出时，body 被加上 modal-open 类，并内联设置 padding-right（比如 17px），用来填补禁用页面滚动后“消失”的滚动条空间，防止内容横向跳动。但它只改 body，不处理 fixed 定位的导航栏、侧边栏等元素，所以这些元素就“漏掉补偿”，视觉上向左一缩——这就是抖动的根源。
padding-right 被覆盖或计算错误的常见表现
你看到的抖动，往往不是没加 padding-right，而是它被干掉了或算错了：
- 全局 CSS 里写了
body { padding-right: 0 !important; }，直接把 Bootstrap 的补偿值覆盖了 - 用了
overflow-y: overlay或scrollbar-gutter: stable，导致document.body.offsetWidth - document.documentElement.clientWidth返回0，Bootstrap 拿不到真实滚动条宽度 - 第三方滚动条库（如
overlay-scrollbars）接管了原生滚动，但 Bootstrap 的检测逻辑仍查原生 DOM，结果补了个0px - 模态框嵌套在某个
overflow: hidden的父容器里，导致body的padding-right实际没生效区域
怎么安全地禁用或修正 padding-right 补偿？
别暴力 !important 覆盖，容易引发后续滚动异常。推荐按优先级选择：
- 如果页面始终有横向留白（比如 max-width + margin: 0 auto），直接在模态框标签上加
data-bs-backdrop="static"：它会跳过padding-right注入，同时保留 ESC 关闭能力 - 如果必须保留点击遮罩关闭，且有 fixed 元素（如顶部导航），给它们加
is-fixed类（Bootstrap 内部会自动同步补偿） - 若用的是自定义滚动方案（如
scrollbar-gutter: stable both），可手动重写Modal的checkScrollbar方法，返回固定宽度（如16），避免依赖 DOM 计算 - 绝对不要只写
.modal-open { padding-right: 0 !important; }—— 这会让body在 modal 关闭后仍残留modal-open类，导致后续页面滚动错位
手写 show/hide 逻辑时最容易漏掉什么？
绕过 bootstrap.Modal.getInstance(el).show() 直接操作 class，等于放弃整个滚动锁定流程：
- 忘了加
document.body.classList.add('modal-open') - 没测真实滚动条宽度，硬写
document.body.style.paddingRight = '17px'（不同系统/缩放下宽度不同） - 监听
hidden.bs.modal后，只删 class 却没还原paddingRight，或者还原成空字符串而非''（注意：设为''才能回退到 CSS 原始值） - 多个 modal 同时存在时，没做计数器管理
modal-open状态，关一个就清空，导致还没关完就提前释放滚动
真正难的不是加一行 CSS，而是理解 padding-right 不是副作用，是 Bootstrap 为保布局稳定做的权衡。一旦你动了它，就得自己扛住所有边界情况：fixed 元素对齐、多 modal 嵌套、第三方滚动库共存、缩放/高 DPI 下的宽度漂移……
