绝大多数场景下直接用 setProperty() 动态设置 CSS 变量即可，浏览器自动重算依赖样式；仅当需运行时创建非全局变量作用域（如组件级主题）时才需注入 <style> 标签。
直接用 document.documentElement.style.setProperty() 就够了
绝大多数场景下，根本不需要把 CSS 变量“计算后注入到 <style> 标签”——你只需要动态设置变量值，浏览器会自动重算所有依赖它的样式。比如主题色切换、字号缩放、暗色模式开关，setProperty() 一行就能生效，且无兼容性问题（IE11+ 全支持）。
常见错误是绕路：先拼 CSS 字符串，再创建 <style>，再插入，结果变量没作用域、无法被继承、调试时看不到实时值，还多出内存泄漏风险。
-
setProperty()设置的是:root上的变量，所有后代元素都能继承，语义清晰 - 值可以是任何合法 CSS 值（
'20px'、'#3498db'、'var(--primary)'），支持单位和嵌套引用 - 修改后，所有使用该变量的 CSS 属性（如
color: var(--text-color)）会自动更新，无需手动触发重绘 - 避免在循环或高频事件中频繁调用——可节流，或用
requestAnimationFrame批量合并
什么时候真得往 <style> 里注入变量定义？
只有一种情况：你需要在运行时生成**全新的、非全局的 CSS 变量作用域**，比如组件级主题隔离、沙箱环境样式注入、或 SSR 后 hydrate 阶段补全缺失的变量定义。这时才需要手动生成 <style> 并写入 :root 或选择器内的变量声明。
关键不是“能不能”，而是“要不要”。多数项目里，这个需求并不存在；强行做，反而破坏 CSS 变量的设计本意（作用域 + 继承）。
立即学习“前端免费学习笔记（深入）”；
- 必须用
textContent写入，不能用innerHTML（XSS 和转义风险） - 变量定义要带作用域前缀，例如
.my-component { --bg: #fff; }，否则会污染全局 - 务必加
data-id标识，比如style.setAttribute('data-id', 'component-theme-123')，方便后续卸载 - 插入前检查
document.head是否可用，SSR 或微前端中可能为null，fallback 到document.documentElement
insertRule 不能直接设变量，但能动态追加带变量的规则
CSSStyleSheet.insertRule() 的作用是向已有样式表追加一条完整 CSS 规则，它不负责定义变量，但可以插入一条「使用变量」的规则。比如你已通过 setProperty() 设置了 --accent，现在想临时加个按钮高亮：
const styleEl = document.querySelector('style[data-id="dynamic-rules"]');
if (styleEl?.sheet) {
styleEl.sheet.insertRule('.btn--highlight { background-color: var(--accent); }',
styleEl.sheet.cssRules.length);
}注意点：
- 不能用
insertRule定义新变量（:root { --x: red; }是无效的规则，会被忽略） - 插入位置索引会随规则增删偏移，建议始终插到末尾（
sheet.cssRules.length） - 跨浏览器对
@media内插入含变量的规则支持一致，但 Safari ≤15.3 对@keyframes内变量支持不全 - 若目标
<style>是内联的（<style>...</style>），sheet可能为null，需提前校验
计算逻辑别塞进 CSS 字符串，封装成函数更可控
所谓“动态计算 CSS 变量”，本质是 JS 里做数值/颜色/布局逻辑，然后把结果喂给 setProperty()。比如根据屏幕宽度算字号、根据用户偏好算对比度、根据数据密度算间距——这些都应该在 JS 函数里完成，而不是拼字符串塞进 <style>。
示例：响应式字体缩放
function updateFontSize() {
const base = 16;
const scale = Math.min(Math.max(window.innerWidth / 1200, 0.8), 1.2);
document.documentElement.style.setProperty('--font-size-base', `${base * scale}px`);
}
window.addEventListener('resize', updateFontSize);
updateFontSize();这样做的好处：
- 逻辑可测试、可 debounced、可与状态管理（如 Pinia/Redux）同步
- 变量值始终是“最终渲染值”，不会因 CSS 字符串拼错（漏括号、引号不闭合）而静默失效
- 调试时直接看
getComputedStyle(document.documentElement).getPropertyValue('--font-size-base')就行，不用翻 DOM 树找<style> - 服务端渲染时，变量初始值可由 JS 注入，无需额外处理样式标签生命周期
真正容易被忽略的是：CSS 变量本身不支持表达式计算（如 calc(var(--a) + 2px) 是合法的，但 var(--a + 2) 不合法）。所有“计算”必须发生在 JS 层，变量只是容器。
