直接改 .modal-content 的 background-color 会失效，因为 Bootstrap 5.3+ 通过 CSS 变量（如 --bs-modal-bg）动态控制背景色，JS 初始化时注入内联样式 style="background-color: var(--bs-modal-bg);"，覆盖普通 CSS 规则；须改变量本身并确保在 JS 运行前于 body 或 :root 中声明。
为什么直接改 .modal-content 的 background-color 会失效
因为 Bootstrap 的 modal 组件样式大量依赖 CSS 自定义变量（如 --bs-modal-bg、--bs-modal-border-color），这些变量在 JS 初始化时被读取并注入内联样式或动态类中。如果你只写 .modal-content { background-color: #f0f0f0; }，它可能被 JS 注入的 style="background-color: var(--bs-modal-bg);" 覆盖——尤其是当 JS 执行后重新计算并设置 style 属性时。
真正起效的方式是覆盖变量本身，且确保它在 Bootstrap 样式之后、JS 运行之前已就绪。
- 必须把变量声明放在
<body>或:root上，否则动态挂载的 modal（如 append 到document.body）无法继承 - 推荐用
body { --bs-modal-bg: #f8f9fa; --bs-modal-border-color: #dee2e6; }，比:root更稳妥，避免 Shadow DOM 或 scoped CSS 隔离问题 - 检查开发者工具的 Computed 面板，确认
.modal-content元素的background-color计算值确实是var(--bs-modal-bg)，而不是硬编码值
哪些 CSS 变量控制弹窗核心外观
Bootstrap 5.3+ 暴露了明确的 modal 相关变量，改这几个就能覆盖绝大多数视觉需求：
-
--bs-modal-bg：模态框背景色（对应.modal-content） -
--bs-modal-border-color：边框颜色（默认浅灰） -
--bs-modal-border-width：边框粗细（单位需带 px，如1px） -
--bs-modal-box-shadow：阴影（可设为none或自定义0 0.5rem 1rem rgba(0,0,0,0.15)） -
--bs-modal-header-padding-y/--bs-modal-header-padding-x：header 内边距
注意：--bs-modal-fade-transform 和 --bs-modal-scale 控制动画效果，但修改它们需同步调整 .modal.fade .modal-dialog 的 transition，否则动画会断裂。
立即学习“前端免费学习笔记（深入）”；
data-bs-custom-class 适合什么场景
data-bs-custom-class 是给整个 .modal 容器加一个额外 class 的入口，但它不是为配色设计的——它是为结构/行为隔离准备的。
- 适合场景：深色模式下整套 modal 独立样式、A/B 测试不同弹窗风格、嵌入 iframe 时避免全局污染
- 不适合场景：只想换个背景色——这时你得重写
.my-modal .modal-content的全部规则（padding、border-radius、box-shadow），容易漏掉细节 - 和变量方案混用会冲突：比如你设了
--bs-modal-bg: #2c3e50，又在.my-modal .modal-content里写background-color: white，后者优先级更高，变量就白设了
如何让变量在 JS 初始化后仍生效
Bootstrap 的 modal.show() 会触发一次样式重计算，如果变量是在 JS 执行后才注入的（比如通过 JS 动态写 document.body.style.setProperty），部分属性可能不更新。稳妥做法是：
- 在 HTML 的
<head>末尾或<body>开头就插入<style>body { --bs-modal-bg: #fff; } - 如果必须运行时切换主题，用
document.body.setAttribute('data-bs-theme', 'dark')配合预设的[data-bs-theme="dark"] { --bs-modal-bg: #343a40; }规则 - 避免在
show.bs.modal事件回调里改变量——此时 DOM 已渲染，改了也不会重绘，要手动调用modal.hide(); modal.show();强制刷新
变量不是“设了就立刻全量生效”的魔法开关，它依赖 CSS 层级、作用域和 JS 生命周期的配合。最易忽略的是：没确认变量是否真的被目标元素读取，而不是被某个中间 class 或内联 style 覆盖掉。
