用CSS变量解耦渐变色锚点，通过语义化变量（如--gradient-start/--gradient-end）配合主题class切换，实现整站渐变风格一键切换；深色模式需重定义适配色值而非机械反色，并确保transition作用于background以支持平滑动画。
直接用 CSS 变量控制渐变色的起止值，再配合主题 class 切换，就能实现一键切换整站渐变风格。关键不是把渐变写死在 background 中，而是把颜色锚点抽成变量，让渐变成为“可配置的表达式”。
渐变色必须拆解为语义化变量
不要这样写：
background: linear-gradient(135deg, #4285f4, #34a853);
而要拆成带语义的变量，比如：
立即学习“前端免费学习笔记（深入）”；
--gradient-start: var(--color-primary);
--gradient-end: var(--color-secondary);
然后在组件中统一调用：
background: linear-gradient(135deg, var(--gradient-start), var(--gradient-end));
这样改主题时，只需调整 --color-primary 和 --color-secondary 的映射，所有渐变自动更新。
深色模式下渐变不能简单反色
亮色主题用蓝→绿渐变，暗色模式若直接套用同色值，可能对比度不足、文字发灰甚至不可读。正确做法是：
- 在
:root.dark中重新定义 --gradient-start 和 --gradient-end，指向更适合暗背景的色阶（如 indigo-400 → cyan-300） - 避免用
filter: invert()或hsl(var(--h), var(--s), calc(100% - var(--l)))这类机械反色，它们破坏色彩意图和可访问性 - 渐变方向（135deg）、圆角、透明度等非颜色参数保持不变，确保视觉节奏一致
支持过渡动画需作用于具体属性
CSS 变量本身不能被 transition，但渐变所依赖的 background-image 是可过渡的（现代浏览器已支持）。启用平滑变化的方法是：
- 给使用渐变的元素加
transition: background 0.3s ease; - 确保 --gradient-start 和 --gradient-end 在 :root 和 :root.dark 中都正确定义，避免 fallback 到 transparent 或初始值
- 慎用
background-image: conic-gradient(...)—— 它目前不支持 transition，建议优先用 linear 或 radial
第三方组件或 SVG 渐变也要纳入体系
容易遗漏的地方：
- SVG 的
<lineargradient></lineargradient>不继承 CSS 变量，需用fill="url(#grad)"配合 JS 动态重绘，或改用 inline style +style="stop-color: var(--gradient-start)" - 按钮伪元素
::after做渐变遮罩时，同样要用background: linear-gradient(...)+var()，不能只靠父级继承 - Ant Design、Element Plus 等 UI 库若未开启 CSS 变量主题支持，其按钮/卡片渐变需额外覆盖样式，例如：
.ant-btn-primary { background: linear-gradient(var(--gradient-start), var(--gradient-end)); }
