直接改 modal-dialog 的 max-width 有时无效，因被更高优先级 css 覆盖、子元素（如 .modal-content）样式干扰、外层多余 div 破坏结构，或未调用 handleupdate() 刷新定位。
直接改 modal-dialog 的 max-width 为什么有时无效
因为 Bootstrap 默认给 .modal-dialog 设了 max-width: 500px，但这个值容易被其他 CSS 规则覆盖或干扰。比如你写了 style="max-width: 800px"，却没加 !important，而项目里某个全局样式表里有更具体的选择器（如 .my-page .modal-dialog），它就赢了优先级。
更常见的是：你在 .modal-content 或 .modal-body 里写了 width: 100%、display: flex 或固定 max-width，这些会间接压制 .modal-dialog 的尺寸传递——浏览器渲染时，子元素约束会影响父容器的“可用空间”计算。
- 检查开发者工具中
.modal-dialog的 computedmax-width值，确认它是否真被设为你想要的数值 - 避免在
.modal-dialog外层额外套div，Bootstrap 只认它的直接子元素为有效模态容器 - 如果用了
modal-dialog-centered，它本身不干预宽度，但和自定义max-width共存没问题
用 modal-lg / modal-sm 类不够用时怎么办
modal-lg 对应 max-width: 800px，modal-sm 是 300px，它们只是预设值，且只控制 max-width，不碰 width 或 margin。一旦你需要 650px、920px 或响应式宽度，就得绕过类名，直接操作样式。
- 推荐写独立 class：
.modal-wide-650 { max-width: 650px; }，然后在 HTML 中：<div class="modal-dialog modal-wide-650"> <li>Bootstrap 5.2+ 支持 CSS 变量：<code>style="--bs-modal-max-width: 720px;"，它比类名优先级高，且不影响响应式断点逻辑 - 别用
width: 720px替代max-width——width会破坏居中定位（transform 偏移仍按原始尺寸算） - 改完尺寸后必须调用：
bootstrap.Modal.getInstance(modalEl).handleUpdate()（Bootstrap 5.2+） - 如果禁用了动画（
data-bs-animation="false"），记得显式清除 transform：.modal-dialog.style.transform = "none"，否则宽高计算会偏差 - 确保
.modal-content没被设height: 100%或min-height，否则会撑开整个视口，让.modal-body的max-height失效 - 真要全屏，优先用
<div class="modal-dialog modal-fullscreen">，别自己覆盖 <code>width和margin - 若需顶部留出状态栏空间，给
.modal-header加padding-top: env(safe-area-inset-top)，而不是调.modal-dialog的margin-top - 检查父容器是否设了
overflow: hidden或固定height，这会让modal-fullscreen无法铺满
动态 JS 设置宽度后为什么位置偏移或滚动异常
手动用 JS 改 .modal-dialog.style.maxWidth 后，Bootstrap 内部的定位逻辑可能没刷新，尤其在模态框已打开状态下。此时 transform: translate(-50%, -50%) 仍基于旧尺寸计算，导致视觉偏移；.modal-body 的滚动也可能失效，因为高度约束没重算。
移动端全屏或适配安全区时的隐藏坑
在 iOS Safari 上，width: 100vw 会因地址栏显示/隐藏抖动；用 modal-fullscreen 虽然方便，但它内部实际用了 width: -webkit-fill-available + env(safe-area-inset-top) 等兜底策略——自己手写 max-width: 100vw 很难复刻完整。
最易被忽略的一点：自定义宽度后，.modal-body 的滚动行为不会自动启用。必须显式给它加 max-height（比如 max-height: calc(100vh - 160px)）并设 overflow-y: auto，否则内容溢出会把滚动条推到 body 上。
