Bootstrap文本色类严格映射$theme-colors变量：text-primary为#0d6efd，text-success为#198754；text-body继承color值，text-black/white硬编码为#000/#fff，text-muted为#6c757d；深色模式需手动启用且不自动翻转。
text-primary 到 text-white 这些类到底对应什么颜色
Bootstrap 的文本色类不是随便起的，而是严格绑定到 $theme-colors Sass 变量映射表里。默认情况下，text-primary 就是 $primary 变量值（#0d6efd），text-success 对应 $success（#198754），以此类推。最常被忽略的是：text-body 不是灰色，而是当前 color 继承值；text-black 和 text-white 是硬编码的 #000 / #fff，不走主题变量。
-
text-muted用的是$gray-600（#6c757d），不是透明度降低，别指望它随opacity动态变化 - 深色模式下这些类**不会自动翻转**——Bootstrap 5.3+ 要配合
data-bs-theme="dark"手动切换，且需确保你启用了bootstrap-dark.css或编译时开启 dark 模式支持 - 如果重定义了 Sass 变量但没重新编译 CSS，页面里还是旧颜色——光改
_variables.scss不生效
bg-light、bg-dark 和 bg-opacity-* 怎么配合用才不踩坑
背景色类和透明度类不能混写成 bg-dark bg-opacity-50 —— Bootstrap 5.2+ 才支持这种组合，老版本会失效。真正生效的逻辑是：bg-opacity-* 会覆盖元素的 background-color 为 rgba() 形式，并设 background-image: none，所以它只对纯色背景有效。
-
bg-dark默认是 #212529，但加了bg-opacity-25后变成rgba(33, 37, 41, 0.25)，此时如果父容器有背景图，就会透出底层内容 -
bg-transparent是个独立类，它直接设background-color: transparent，和bg-opacity-0行为不同——后者仍保留原色通道，只是 alpha=0，某些场景下渲染表现有细微差异 - 不要对
button元素滥用bg-opacity：Firefox 下可能触发按钮焦点 outline 渲染异常
border-primary、border-0 和 border-opacity-* 的实际行为差异
边框类和文本/背景类逻辑不一致：border-primary 设置的是 border-color，而 border-0 是 border: 0，二者优先级不同。更关键的是：border-opacity-* 类根本不存在——Bootstrap 官方没提供边框透明度工具类，想调边框透明度得自己写 style="border-color: rgba(...)" 或用 Sass 自定义。
-
border（无后缀）等价于border: 1px solid var(--bs-border-color)，值来自$border-color变量，不是$gray-300硬编码 -
border-top这类方向类只设单边，但会把其他三边重置为0，容易意外清掉已有边框 - 在
table中用border-secondary，可能被table-striped的 zebra 样式覆盖，得加!important或提高选择器权重
如何快速查清某个颜色类在当前项目中实际生效的值
别猜，直接打开浏览器开发者工具，选中元素，在 Styles 面板里找对应类名，点开它右侧的色块小图标，就能看到最终计算出的 RGB/HEX 值。如果看到的是 var(--bs-primary)，说明你用的是 CSS 变量版 Bootstrap，就得去检查 :root 或组件上的 style 属性里这个变量是否被覆盖过。
- 用
getComputedStyle(el).getPropertyValue('color')在控制台运行，能拿到真实渲染值，比看样式表更可靠 - 如果项目用了 CSS-in-JS（比如 styled-components），这些类可能被隔离作用域，压根不生效——先确认 class 是否真进了 DOM
- 某些构建工具（如 Vite + CSS scope）会自动哈希类名，
text-danger可能被重命名为text-danger_xxx，导致你写的类名不匹配
颜色类看着简单，但变量注入、CSS 优先级、构建时处理、深色模式适配这四层嵌套下来，一个 text-warning 渲染成灰色也不奇怪。
