Vue.js 响应式数据驱动 CSS 变量实现动态主题，通过 ref/computed 管理主题状态、document.documentElement.style.setProperty 动态设置 :root 变量，并用 watchEffect 同步更新；配合 provide/inject 实现跨组件主题响应与业务联动。
Vue.js 响应式数据结合 CSS 变量实现动态主题，核心是让 JavaScript 的响应式状态驱动 CSS 自定义属性的变化，从而触发样式层自动更新。不靠切换 class、不硬编码颜色值，也不依赖第三方库，整个流程轻量、可维护、兼容性好。
在根节点定义并动态设置 CSS 变量
所有主题变量必须作用在能被子元素继承的节点上（通常是 :root 或 html），才能被全站样式读取。切换主题的本质不是改样式，而是改变量值：
- 用
ref或computed定义响应式主题状态，例如const theme = ref('light') - 在
onMounted中从localStorage读取上次选择，初始化主题 - 通过
document.documentElement.style.setProperty('--primary-color', '#409eff')批量写入变量 - 避免 SSR 报错：加判断
if (typeof document !== 'undefined')
在组件样式中用 var() 引用变量
样式层不感知 Vue，只认 CSS 变量。只要变量定义正确、作用域覆盖到位，组件内直接使用即可生效：
-
<style scoped>中写color: var(--text-primary);，scoped 不影响变量穿透 - 支持 fallback 写法：
background: var(--bg-surface, #fff)，增强容错 - 可组合使用：
border-color: rgba(var(--primary-rgb), 0.2)，提升灵活性 - 变量名建议语义化，如
--text-primary、--border-base，而非--c1
用 watchEffect 或 watch 同步状态与样式
响应式数据变化后，需主动将新值映射为 CSS 变量。推荐用 watchEffect 自动追踪依赖：
立即学习“前端免费学习笔记（深入）”；
- 监听
theme或更细粒度的primaryColor，触发批量 setProperty - 把映射逻辑封装成函数，比如
updateThemeVars(theme.value)，便于复用和测试 - 若主题含明暗模式+色系两层配置，可用 reactive 包裹整个主题对象，watch 深层变化
- 首次设置时可跳过重复赋值，用 Map 缓存已设变量名，减少 DOM 操作
配合 provide/inject 实现跨层级主题反馈
除了样式切换，业务逻辑也常需感知主题变化。provide/inject 提供了一条轻量通路：
- 根组件
provide('theme', { theme, setTheme })，暴露响应式引用本身 - 任意子组件
const { theme } = inject('theme')，模板中直接用{{ theme.value }} - 可在子组件中
watch(theme, ...)做额外处理，比如调整图标、日志上报 - 避免 provide 普通对象——只有 ref/reactive 才能保证 inject 后的响应性
