最稳方案是使用 --bs-modal-max-width CSS 变量，它优先级高于预设类、无需 !important，且必须作用于 .modal-dialog 元素；vw 单位比 % 更可靠，modal-fullscreen 类需加在 .modal-dialog 上才生效；width 不生效因 Bootstrap 依赖 max-width 和 flex 居中机制。

直接用 --bs-modal-max-width CSS 变量最稳

bootstrap 5.2+ 原生支持通过 css 变量控制模态框宽度，--bs-modal-max-width 是唯一能可靠覆盖所有断点且不破坏响应式逻辑的方式。它优先级高于 modal-lg、modal-xl 等预设类，也不需要 !important 或复杂选择器。

常见错误现象：给 .modal-dialog 写 style="width: 80%" 没反应；在 JS 初始化里传 { width: '80%' } 报错或被忽略——Bootstrap 根本不认这个参数。

• 正确写法：<div class="modal-dialog" style="--bs-modal-max-width: 80vw;"> <li> <code>vw 单位比 % 更可靠：它基于视口宽度，不受父容器 padding/margin 干扰
• 别混用 --bs-modal-width：它只影响非响应式场景下的基础宽度，--bs-modal-max-width 才是控制上限的主力
• 作用位置必须是 .modal-dialog 元素本身，加在 .modal 或 .modal-content 上无效

modal-fullscreen 类不是“百分比”，但能撑满视口

如果你要的是“尽可能宽”，而不是精确百分比（比如 75%），modal-fullscreen 是更干净的选择——但它有版本和断点限制。

常见错误现象：加了 modal-fullscreen 却没效果；全屏后四角有圆角白边；内容溢出但不滚动。

• 必须加在 .modal-dialog 上：<div class="modal-dialog modal-fullscreen">，加错位置（如 <code>.modal）会导致定位异常
• 仅 Bootstrap 5.2+ 原生支持，旧版本会静默忽略——检查开发者工具中是否有 max-width: 100vw 规则来确认
• 断点后缀决定生效范围：modal-fullscreen-sm-down 表示所有屏幕都全屏；modal-fullscreen-lg-down 表示 ≤992px 全屏
• 全屏后仍需手动处理 .modal-content 的 border-radius: 0，否则四角留白

自定义 class 覆盖 max-width 适配老版本

Bootstrap 4 或 5.1- 无法用 CSS 变量时，唯一兼容方案是重写 .modal-dialog 的 max-width，但要注意 flex 居中机制和内边距消耗。


VPS Bootstrap
从零启动全新 VPS，完成 OpenClaw 完整部署，包括备份/恢复及恢复后验证。用于 OpenClaw 部署。
下载

常见错误现象：“设了 max-width: 800px，但内容区实际只有 760px 宽”；响应式断点下宽度突然跳变。

• HTML 中加自定义 class：<div class="modal-dialog modal-wide"> <li>CSS 中写：<pre class="brush:php;toolbar:false;">.modal-wide { max-width: 80vw !important; }</pre>（<code>!important 是必须的，因为 Bootstrap 的媒体查询规则优先级高）
• 若需响应式，配合媒体查询：

  @media (min-width: 992px) { .modal-wide { max-width: 90vw !important; } }

• .modal-content 默认有 padding: 1rem，实际可视宽度 = max-width - 2rem，预留空间避免内容贴边

为什么 width 不生效，而必须动 max-width

Bootstrap 的 .modal-dialog 使用 flex + transform 居中，width 属性被设计为“建议值”，真正起约束作用的是 max-width 和媒体查询组合。

常见错误现象：写 width: 100% 后模态框缩成一条线；加了 !important 也没用；JS 动态改 style.width 完全无反应。

• width 在 flex 容器中不主导尺寸计算，max-width 才是最终裁决者
• Bootstrap 的媒体查询按断点层层覆盖：sm、md、lg 各有一套 max-width 值，硬覆盖需确保选择器优先级足够
• 移动端 Safari 对 vw 支持良好，但对 calc(100% - 60px) 类动态计算偶有渲染延迟，优先选纯 vw

真正容易被忽略的是：无论用变量、全屏类还是自定义 class，.modal-content 的 padding 和 .modal-header/.modal-footer 的固定高度都会吃掉可观的可用空间。如果内容区域需要精确占屏比，得把这部分减进去——比如 80vw 是容器宽度，实际内容宽度可能只有 calc(80vw - 2rem)。