Bootstrap 4 不支持 data-bs-theme，必须用 class 切换：需将 bootstrap-dark 类加在 body 上，确保暗黑 CSS 在 Bootstrap 主 CSS 之后加载，并手动切换 class 且适配自定义组件样式。
Bootstrap 4 不支持 data-bs-theme，必须用 class 切换
Bootstrap 4 官方没有 data-bs-theme 属性机制，所有主题切换都依赖 CSS class（如 bootstrap-dark）驱动。你不能照搬 Bootstrap 5.3+ 的写法——改 document.documentElement.setAttribute('data-bs-theme', 'dark') 在 v4 下完全无效。
主流方案是引入第三方暗黑主题包（如 @forevolve/bootstrap-dark），它通过覆盖原有类名样式实现切换。核心逻辑是：<body class="bootstrap-dark"> 触发整套深色样式重载，而非变量更新。
- 必须把主题 class 加在
<body>上，加在<html>或容器 div 里不起作用 - 确保
bootstrap-dark.min.css在bootstrap.min.css之后加载，否则样式被覆盖 - 不要混用多个暗黑主题 CSS 文件（比如同时引入
bootstrap-dark和自定义dark.css），容易因选择器优先级冲突导致部分组件不生效
切换时必须手动 reload 样式或替换 class，不能只改属性
Bootstrap 4 没有 bootstrap.Theme.getOrCreateInstance().update() 这类 API，也没有 CSS 变量重计算机制。所谓“切换”，本质是 DOM class 变更 + 浏览器重新匹配样式规则。
典型实现就是操作 document.body.className：
立即学习“前端免费学习笔记（深入）”；
const toggleBtn = document.getElementById('theme-toggle');
toggleBtn.addEventListener('click', () => {
const body = document.body;
if (body.classList.contains('bootstrap-dark')) {
body.classList.remove('bootstrap-dark');
localStorage.setItem('theme', 'light');
} else {
body.classList.add('bootstrap-dark');
localStorage.setItem('theme', 'dark');
}
});
- 别用
setAttribute('class', ...)全量覆盖，会丢掉其他必要 class（如container所在的 wrapper 类） - 初始化时从
localStorage.getItem('theme')读取，而不是只看prefers-color-scheme，否则用户上次选择丢失 - 如果用了 jQuery，避免用
$('body').removeClass().addClass()这种粗暴写法——它会清空所有 class，应改用.toggleClass('bootstrap-dark')
自定义组件必须显式适配 dark class，否则颜色不变
Bootstrap 4 的按钮、卡片等组件样式写死在 CSS 里（比如 .btn-primary { background-color: #007bff; }），bootstrap-dark 包只是提供了另一套同名 class 的重写规则。但你自己写的 .card-dashboard 或 .stat-badge 不会自动响应 body.bootstrap-dark ——除非你主动写对应规则。
正确写法是利用父级 class 做作用域限定：
.card-dashboard {
background-color: #f8f9fa;
color: #212529;
}
body.bootstrap-dark .card-dashboard {
background-color: #212529;
color: #f8f9fa;
}
- 不要在
.card-dashboard内部用var(--bs-bg)—— Bootstrap 4 根本没定义这些变量 - 避免用
!important强行覆盖，优先靠选择器权重（如body.bootstrap-dark .btn比.btn优先级高） - 检查浏览器开发者工具的“计算样式”，确认最终生效的是 dark 版本规则，而不是被前面的浅色规则截断
prefers-color-scheme 只能做初始值参考，无法自动同步
window.matchMedia('(prefers-color-scheme: dark)') 返回的是当前快照，不是响应式信号。Bootstrap 4 本身不监听这个事件，也不会在系统主题切换时自动翻转 body 的 class。
若需自动响应，得自己补监听逻辑：
const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
function handleThemeChange(e) {
const theme = e.matches ? 'dark' : 'light';
if (localStorage.getItem('theme') === null) {
document.body.classList.toggle('bootstrap-dark', e.matches);
}
}
mediaQuery.addEventListener('change', handleThemeChange);
handleThemeChange(mediaQuery); // 立即执行一次
- 只在
localStorage为空时才按系统偏好设置，否则尊重用户手动选择 - 别在
DOMContentLoaded之后才绑定监听器，否则可能错过首次触发 - Safari 14+ 支持该 API，但 iOS 13.7 及更早版本不支持，需降级 fallback（比如默认亮色）
