CSS 无法直接动画化 linear-gradient() 的颜色或色标位置，因 background-image 不在动画属性白名单中，只能通过 background-position 或多层 opacity 切换实现渐变动画效果。
不能直接用 @keyframes 动画化 linear-gradient() 的颜色值或色标位置——浏览器根本不支持插值，写了也静默失效。
为什么 background-image: linear-gradient() 无法被 @keyframes 动画
浏览器对 CSS 动画属性有明确白名单，background-image 不在其中。即使你写：
div { animation: changeGrad 2s infinite; }
@keyframes changeGrad {
0% { background-image: linear-gradient(red, yellow); }
100% { background-image: linear-gradient(blue, green); }
}
结果只会是硬切（逐帧切换），没有过渡动画。这不是 bug，是规范限制。
常见错误现象：
立即学习“前端免费学习笔记（深入）”；
- 用
transition: background 0.3s试图过渡整个渐变声明——完全无反应 - 把多个
linear-gradient()塞进background简写里，覆盖了background-size和background-position，导致后续位移动画失效 - 误以为改
--color-a就能驱动渐变变化，但没配合 JS 或伪类触发重绘
--gradient-angle 和 --stop-color 需要配合 JS 或伪类才生效
CSS 自定义属性本身不可动画，但可以作为“开关”或“中间变量”，由 JS 修改或伪类切换来触发重绘。关键在于：必须让浏览器重新计算并应用该变量参与的渐变声明。
实操建议：
- 定义变量时显式写出单位或格式，比如
--stop-1: #ff6b6b;、--angle: 90deg;，避免空值或语法错误 - 用
:hover切换类来修改变量：.btn:hover { --angle: -45deg; }，再让渐变依赖它：background: linear-gradient(var(--angle), var(--stop-1), var(--stop-2)); - JS 修改时用
element.style.setProperty('--angle', '135deg')，不要直接操作style.cssText，否则会覆盖其他自定义属性 - 注意：Safari 对
var()在linear-gradient()中的解析较慢，首次切换可能有延迟，可加will-change: background提前提示（仅限必要元素）
真正可动画的替代路径只有两个
想让渐变“动起来”，只能绕过 background-image 本身的限制，走浏览器真正支持动画的属性：
-
background-position：最稳定，适合滑动效果。必须配background-size: 200% 100%，且动画从0% 0%到-100% 0%才能完整滚动；移动端需加transform: translateZ(0)防卡顿 -
opacity+ 多层background-image：适合阶段式切换（如 A→B→C）。用::before和::after各置一层渐变，只动画opacity和z-index，两层渐变的方向、色标位置必须严格一致，否则错位明显
别指望纯 CSS 能让色标位置（如 red 30% → red 70%）平滑过渡——目前没有任何浏览器支持。
字体渐变动画必须用 background-clip: text + background-position
给文字加渐变色，本质是把渐变当背景，再用文字做遮罩。动画逻辑和块级元素一致，但多一个兼容性陷阱：
- 必须写
-webkit-background-clip: text和background-clip: text，缺一不可 -
-webkit-text-fill-color: transparent是必需的，仅设color: transparent不生效 - 动画
background-position时，若容器有 padding 或 line-height 不均，文字边缘易露底色；建议用display: inline-block包裹文字，并设background-clip: text在该块上 - Firefox 目前不支持
background-clip: text的动画，需降级为单色color过渡
最易被忽略的一点：所有基于 background-position 的方案，都依赖渐变图“足够宽”。如果只设 background-size: 150% 100%，动画到 -100% 0% 时会提前露出重复色块——务必确保尺寸 ≥ 200%，且方向与渐变轴对齐。
