bg-dark-subtle 的色值由 Sass 变量 $dark-bg-subtle 动态生成，浅色模式下默认为 #e9ecef，深色模式（data-bs-theme="dark"）下才呈现暗色微调变体，语义上专用于暗主题的柔和次级背景，非固定深色。
bg-dark-subtle 的色值不是固定写死的，而是由 Sass 变量动态生成
bootstrap 5.3+ 中，bg-dark-subtle 类不对应一个硬编码的十六进制值（比如 #212529），而是由 $dark-bg-subtle 变量编译而来。这个变量默认基于 $dark（即 #343a40）通过 color-mix() 或 shade-color() 函数轻微提亮生成，最终在标准浅色模式下编译为 #e9ecef（浅灰，接近 bg-light，但语义不同）。
关键点在于：bg-dark-subtle 是“暗色主题下的柔和背景”，不是“深色背景”。它只在 data-bs-theme="dark" 生效时才真正体现设计意图；在浅色模式下，它和 bg-light 视觉几乎一致，但语义更偏向「与 dark 主题配套的次级背景」。
为什么 inspect 看到的色值可能和文档不符
常见现象：你在浏览器开发者工具里选中一个带 bg-dark-subtle 的元素，看到计算出的 background-color 是 rgb(233, 236, 239)（即 #e9ecef），但你预期它该是深色——这是因为：
- 你没设置
data-bs-theme="dark"，所以 Bootstrap 仍运行在默认浅色模式下，$dark-bg-subtle被当作“暗色系的浅背景”处理 - 你手动覆盖了
$dark却没同步重定义$dark-bg-subtle，导致编译结果偏离预期 - 你用了 CSS-in-JS 或 Tailwind 混用，样式优先级覆盖了 Bootstrap 的变量链
如何查到你项目里实际生效的色值
最可靠的方式不是猜或查文档，而是直接读你当前编译后的 CSS：
- 打开浏览器 DevTools → Elements 面板 → 找到目标元素 → 看 Styles 面板里
background-color的最终计算值（带“computed”标签那行） - 如果用了 Sass，去你的
_variables.scss里确认是否重写了$dark-bg-subtle；没重写就看 Bootstrap 源码中scss/_variables-dark.scss的定义 - 注意：Bootstrap 官方 CDN 版本（如 5.3.3）中，
bg-dark-subtle在浅色模式下确实输出#e9ecef，在深色模式下才切换为#343a40的微调变体（如#2b3035）
别把它和 bg-dark、bg-black 混用
bg-dark-subtle 和 bg-dark 完全不是同一类用途：
-
bg-dark→ 固定深灰背景（#343a40），用于需要高对比度的容器 -
bg-dark-subtle→ “暗色主题中的轻量背景”，常用于侧边栏、分组标题下方、卡片内部分隔区域，强调层级而非主体 -
bg-black→ 纯黑（#000），Bootstrap 5 默认不提供该类，需自定义；强行用会破坏 WCAG 对比度要求
真正容易被忽略的是：这个类的设计初衷是配合 data-bs-theme="dark" + text-body-secondary 使用。单独在浅色页里加 bg-dark-subtle，既违背语义，又起不到视觉区分作用。
