直接改 modal-dialog 的 max-width 和 max-height 是唯一稳定生效的路径，因 Bootstrap 居中依赖 transform 锚点，width 无效且破坏定位；需配合 CSS 变量或自定义 class 覆盖，并调用 handleUpdate() 刷新布局。
直接改 modal-dialog 的 max-width 和 max-height 是唯一稳定生效的路径，其他方式基本会失效或引发定位/滚动异常。
为什么 style="width: 800px" 或 data-bs-width 不起作用
Bootstrap 本身不提供 width、height 等配置项，data-bs-* 属性里也没有这类参数；width 在 flex 定位下会被忽略，真正参与居中计算的是 max-width；浏览器对原生表单控件和模态结构有强 UA 样式约束，硬设 width 只会破坏 transform: translate(-50%, -50%) 的锚点逻辑。
- jQuery 写法如
$('#myModal').modal({ width: '900px' })直接报错——Bootstrap 原生 JS 不支持该配置 -
style="width: 90%"在modal-dialog上无效，因为其父容器（modal）未设display: flex，且居中靠transform，不是靠宽度撑开 - 改
modal-content的width会导致内容被裁切或左右留白异常，因它只是子元素，不控制外层布局尺寸
正确设置 Modal 宽度：用 class 或 CSS 变量覆盖 max-width
推荐加自定义 class 到 modal-dialog 元素，再在 CSS 中重置 max-width，兼容所有 Bootstrap 5.x 版本，不影响响应式断点逻辑。
- HTML 中：
<div class="modal-dialog modal-wide-850"> <li>CSS 中：<code>.modal-wide-850 { max-width: 850px; } - 若需响应式，配合媒体查询：
@media (min-width: 992px) { .modal-wide-850 { max-width: 90vw; } } - Bootstrap 5.2+ 更推荐用 CSS 变量：
<div class="modal-dialog" style="--bs-modal-max-width: 850px;">，它优先级高于类名，且自动适配断点<li>避免只写 <code>width: 850px——这会让transform偏移计算错乱，视觉上偏右偏下 - 给
modal-body加max-height: calc(100vh - 180px)（减去 header + footer + padding 高度），并设overflow-y: auto - 同时确保
modal-content是display: flex; flex-direction: column，否则max-height不生效 - 如果用了
modal-fullscreen，记得检查父容器是否设了overflow: hidden，否则全屏可能被截断 - 禁用动画时（
data-bs-animation="false"），要手动清transform：modalDialog.style.transform = "none"，否则高度计算偏差 - Bootstrap 5.2+ 必须调用：
bootstrap.Modal.getInstance(modalEl).handleUpdate() - 该方法需在 Modal 已初始化后执行，比如在
shown.bs.modal事件回调里改尺寸再调用 - 如果 Modal 尚未打开，可先调用
new bootstrap.Modal(modalEl)初始化实例，再改尺寸+调用handleUpdate() - 漏掉这步是线上最常见“宽高改了但看起来没变”的原因——不是样式没生效，而是定位逻辑没更新
高度控制必须配合 modal-body 的 max-height 和布局
Modal 高度不能只靠 max-height 控制，因为默认 modal-content 是 display: block，内容会无限制撑高；滚动条出现在页面 body 上，而不是框内，说明 modal-body 没被约束。
动态修改后必须调用 handleUpdate() 否则位置/滚动错乱
JS 手动改完 modal-dialog 的 max-width 或 max-height 后，如果不刷新内部状态，Bootstrap 仍按旧尺寸做 transform 偏移和滚动区域计算，导致模态框“飘”在屏幕一角、modal-body 滚动失效、点击关闭按钮无反应。
真正难的不是设宽高，而是让整个尺寸链（modal → modal-dialog → modal-content → modal-body）都对齐约束逻辑，尤其当涉及移动端视口变化、Safari 地址栏收放、或禁用动画时，任意一环松动都会导致滚动/定位/点击全部失常。
