@property 无法驱动渐变颜色动画，因为 CSS 变量在 linear-gradient() 中仅为字符串占位符，浏览器不会运行时解析注入；所有稳定渐变动画只能通过 background-position 位移或切换整个 background-image 值实现。
不能直接用 @property 动画化 background-image 或 linear-gradient 本身——CSS 变量无法绑定到渐变函数的参数上，@property 对此无效。
为什么 @property 无法驱动渐变颜色动画
CSS 自定义属性（--color-a、--angle）在 linear-gradient() 中只是字符串占位符，浏览器不会在运行时将变量值“注入”并重新解析整个渐变函数。即使你声明了 @property --angle { syntax: "<angle>"; inherits: false; initial-value: 45deg; }</angle>，并在 background: linear-gradient(var(--angle), red, blue); 中使用，该写法不被任何浏览器支持，会直接退化为无背景或解析错误。
常见误判场景：
- 开发者看到
@property支持<angle></angle>类型，就以为能用来动画渐变方向 - 试图用变量控制 color stop 位置（如
red 0%, blue var(--stop)），但 stop 位置不是独立可插值属性，整条background-image值仍被视为不可动画的字符串 - 在 DevTools 里手动修改变量值发现“似乎动了”，其实是缓存或重绘假象，非真实 CSS 动画
真正可用的渐变动画路径只有两种
所有稳定、跨浏览器、可 GPU 加速的渐变动画，都绕不开以下任一机制：
立即学习“前端免费学习笔记（深入）”；
-
移动背景图位置：用
background-position+ 大于容器的background-size（如400% 100%），配合@keyframes平移——这是最主流、性能最好、兼容性最强的方式 -
切换整个 background-image 值：在
@keyframes中显式写出多个linear-gradient()，靠浏览器对background-image的离散过渡（实际是跳变，非平滑插值）实现色彩轮换；仅适合低频、风格化切换，不适合“流动”效果
注意：background-color 只支持单色，无法表达渐变；transition 也无法作用于 background-image 的颜色成分——它没有数值维度可插值。
想用变量控制动画？只能间接绑定
你可以用 CSS 变量控制 @keyframes 中的可动画属性，但变量本身不参与渐变计算：
- 用
--duration控制animation-duration：animation: slideGradient var(--duration) ease-in-out infinite; - 用
--size控制background-size：background-size: var(--size) 100%;（需确保--size是合法尺寸值，如400%） - 用
--pos-start和--pos-end控制关键帧位移范围，但必须提前写死在@keyframes里，不能动态生成规则
也就是说：@property 在这里只适合做“动画参数开关”，不是“渐变内容控制器”。强行让它承担后者，只会遇到 silent fail 或布局抖动。
容易忽略的兼容性与性能陷阱
即便走标准路径，仍有几个硬伤常被漏掉：
- Safari 15.4+ 才完整支持
background-position百分比动画；旧版 Safari 需要-webkit-前缀且必须同时加在@keyframes和animation属性上 -
background-size: 400% 100%在高 DPR 屏幕下可能触发纹理重采样，导致边缘轻微模糊；若对精度敏感，改用background-size: 200vw 100vh+background-attachment: fixed替代 - 多层渐变叠加动画时，每个
background-image都是一次绘制层，超过 3 层易触发合成层爆炸，建议用will-change: background-position仅对活跃元素启用 - 未响应
@media (prefers-reduced-motion: reduce)会导致残障用户设备强制关闭动画，应加降级：@media (prefers-reduced-motion: reduce) { animation: none; }
渐变动画的“可控性”始终受限于 CSS 渲染管线的设计边界——它不是 JS 那种任意计算的环境。把变量当成胶水去粘合动画节奏可以，但别指望它变成渐变的调色盘。
