CSS变量不支持函数调用，只能替换原子参数；需拆解角度、起止色为独立变量，在linear-gradient()内显式引用；暗色模式通过@media重定义变量；background简写会破坏过渡动画，应单独设置background-image并声明transition。
为什么不能直接把整个 linear-gradient() 赋给 CSS 变量
因为浏览器不解析变量值里的函数调用——--gradient: linear-gradient(45deg, red, blue) 看似合法，但实际在 background-image: var(--gradient) 中会被当作无效值降级为 none。这不是语法错误，而是 CSS 变量设计限制：它只支持“值替换”，不支持“函数体替换”。你真正能动态控制的，只有颜色、角度、停点位置这些原子级参数。
怎么拆解渐变参数并用 var() 安全调用
把渐变中可变的部分单独抽成变量，再在 linear-gradient() 内显式调用：
-
--color-start和--color-end必须是合法颜色值（如#4facfe、hsl(200, 80%, 60%)），不能是red这类关键词（IE/旧 Safari 不兼容） -
--gradient-angle推荐用数字加单位（如135deg），避免to bottom right这类关键字——后者无法被 JS 动态计算或动画过渡 - 写法必须是：
background-image: linear-gradient(var(--gradient-angle), var(--color-start), var(--color-end));，var()必须出现在函数参数位，不能藏在字符串里
如何让渐变随暗色模式自动切换
别重写整条 background-image 声明，只覆盖变量值：
- 在
:root里定义默认值：--color-start: #4facfe; --color-end: #00f2fe; - 在
@media (prefers-color-scheme: dark)块内重新赋值：--color-start: #0a3d62; --color-end: #1e5799; - 确保所有使用这些变量的元素都继承自同一作用域（比如都基于
:root或某个父容器），否则变量不会级联生效
为什么 background 简写会破坏渐变过渡动画
当你写 background: linear-gradient(...)，浏览器会把整个背景声明当做一个复合值处理。一旦变量更新，background 属性无法精确 diff 两个渐变函数的差异，只能全量重绘——导致“闪一下”而非平滑过渡。
立即学习“前端免费学习笔记（深入）”；
- 正确做法：只用
background-image单独设置渐变，其他如background-color、background-size分开写 - 过渡必须明确写
transition: background-image 0.4s ease；Safari 16.4+ 才真正支持，旧版 Safari 会跳过动画 - 调试时看 computed style，如果
background-image显示为none或空值，八成是简写冲突或变量未声明
--color-start，还是复用全局主题变量？混用时容易覆盖错层级，最终改一个色，三处渐变全崩。这点没法靠工具自动检测，得靠命名约定和模块化声明习惯兜底。 
