改了CSS变量但部分组件没变色，是因为引用链断裂：硬编码值、第三方组件未接入、作用域限制、拼写错误或派生变量缺失；需确保所有样式引用变量、成对设置主色及RGB值、正确使用JS批量更新并处理兼容性。
直接改 :root 里的 CSS 变量就能批量生效，但必须确保所有组件样式都引用了这些变量，而不是写死值；漏引或硬编码会绕过变量控制。
为什么改了变量但部分组件没变色？
不是变量没生效，是引用链断了。常见原因：
-
border-radius: 4px这种硬编码写法，完全不读--radius，得改成border-radius: var(--radius) - 第三方组件（如 Ant Design）没用你的变量，得查它暴露的钩子名，比如
--ant-border-radius，再单独设 - 变量定义在某个 class 内部（如
.theme-dark { --color: #000; }），但目标元素不在该作用域下，读不到 - 拼写错误：
var(--color-pirmary)少了个r，浏览器静默 fallback 到初始值
Bootstrap 5 组件批量改色必须同步设哪些变量？
只改 --bs-primary 不够，它被大量派生计算依赖。例如 box-shadow: rgba(var(--bs-primary-rgb), .2)，--bs-primary-rgb 缺失就回退默认蓝。
- 必须成对设置：
--bs-primary和--bs-primary-rgb（RGB 值别手算，用工具转，#6f42c1 →111, 66, 193） - 深色模式下，别手动切
.darkclass，用document.documentElement.setAttribute('data-bs-theme', 'dark')，Bootstrap 内置媒体查询会自动接管 - Portal 类组件（tooltip/modal）渲染在
body底部，但依然读:root，失效一定是变量漏设，不是 DOM 位置问题
如何安全地用 JS 批量更新多个 CSS 变量？
别用 cssText 覆盖整个 style 字符串，会清掉其他内联样式。推荐封装函数一次设多个：
立即学习“前端免费学习笔记（深入）”；
function setBSVars(vars) {
Object.entries(vars).forEach(([key, value]) => {
document.documentElement.style.setProperty(key, value);
});
}
setBSVars({
'--bs-primary': '#6f42c1',
'--bs-primary-rgb': '111, 66, 193',
'--bs-primary-text-emphasis': '#2a1b5d'
});
- 变量名必须带双短横线前缀，
--bs-primary不能写成-bs-primary - 确保 DOM 已挂载，
document.documentElement在DOMContentLoaded后才可用 - IE 不支持 CSS 变量，若需兼容，得加降级 fallback（如 class 切换）
真正麻烦的不是设变量，而是确认每个组件是否真用了变量——尤其那些从 reset.css、第三方库或旧代码继承来的硬编码值，它们会悄无声息地绕过你的全局控制。
