直接改 margin 会破坏 Bootstrap 模态框的居中锚点：margin: auto 依赖 flex 容器，transform 居中依赖计算偏移，手动覆盖会导致贴左上角、双重偏移、动画失效或 Safari 下因地址栏变化引发抖动。
为什么直接改 margin 会让模态框偏移或错位
Bootstrap 的 .modal-dialog 默认靠 margin: auto（配合 flex 容器）或 transform: translate(-50%, -50%)（旧版居中逻辑）实现居中。手动覆盖 margin 会直接破坏这层计算锚点：
-
margin: 0后，flex 居中失效，模态框贴左上角 -
margin-top: 20%等固定值，在内容高度变化、视口缩放、移动端地址栏显隐时全部失准 - 若同时用了
modal-dialog-centered，再加自定义margin会导致 transform 和 margin 双重偏移，实际位置飘忽 - 某些定制主题或第三方插件会重置
.modal的display，使margin: auto完全不生效
modal-dialog-centered 不生效？先检查这三处
这个类在 Bootstrap 5 中是垂直居中最轻量的解法，但不是“一加就灵”：
- 确保它只加在
.modal-dialog元素上，而不是.modal或.modal-content - 确认没在 CSS 中全局重写
.modal-dialog的margin或transform，尤其警惕带!important的规则 - 检查父级
.modal是否被设了overflow: hidden或height: 100%——这会把transform计算出的上半部分直接裁掉
需要微调上下间距？用 margin-top 还是 top？
如果业务真有“比默认高一点”的需求（比如避开顶部固定导航），优先动 margin-top，而非 top：
-
margin-top: 4rem是安全的：它仍走 flex 流程，不会破坏 backdrop 覆盖范围或键盘焦点逻辑 -
top: 100px很危险：它强制脱离 flex 布局，.modal的overflow: hidden可能切掉顶部，且动画（fade）会失效 - 若必须动态控制，监听
shown.bs.modal事件后用 JS 设置：$(this).find('.modal-dialog').css('margin-top', '3rem')，别在show.bs.modal阶段操作
移动端 Safari 下 margin 抖动的根本原因
地址栏收起/展开会改变 vh 单位和视口尺寸，而手动写的 margin-top: 10% 或 margin-top: 20vh 会随之一同跳变。这不是 Bug，是浏览器行为：
- 不要依赖
vh做模态框定位，它在 Safari 移动端不可靠 - 真正稳定的方案是：保留
modal-dialog-centered，仅对.modal-content内部加padding-top: env(safe-area-inset-top)来避让状态栏 - 如需整体上移，用
margin-top: clamp(1rem, 5vh, 3rem)替代固定vh值，至少能限制波动范围
