CSS变量重置导致帧率骤降，根本原因在于浏览器将内联变量（如var(--x)）默认视为字符串而非可插值数值，致使transform、font-variation-settings等属性动画退化为逐帧硬切；必须用@property显式声明syntax: ""并保持起止值类型一致，才能触发平滑插值。
为什么CSS变量重置会导致帧率骤降
不是变量本身慢，而是浏览器对 font-variation-settings、transform 等属性中内联的 CSS 变量（如 var(--x)）默认不视为可插值数值类型。一旦在 @keyframes 中写 transform: translateX(var(--offset))，动画引擎就无法做平滑插值，转而逐帧硬切——尤其在 60fps 下，每帧只推进 1–2px，人眼立刻感知卡顿或跳变。
用 @property 显式声明变量类型才能触发插值
必须让浏览器知道这个变量是数字、能线性过渡，否则它永远当字符串处理。仅靠 :root { --offset: 0px; } 不够。
-
@property是唯一标准方案：在 CSS 中提前注册，指定syntax: "<number>"</number>和inherits: false - 写法必须严格：
@property --offset { syntax: "<number>"; inherits: false; initial-value: 0; }</number> - 之后
transform: translateX(calc(var(--offset) * 1px))才真正可插值（注意单位要显式参与计算） - 不支持
@property的浏览器（如 Firefox 当前仍无）需降级为 JS 驱动：element.animate({ transform: ['translateX(0px)', 'translateX(100px)'] }, ...)
避免在关键帧里混用变量与字面量
动画起止值类型必须完全一致，否则插值中断。Chrome 对小数精度敏感，--offset: 100 和 --offset: 100.0 在某些版本中会被判为不同类型。
- 禁止写
0% { --offset: 0; } 100% { --offset: 100.0; }—— 小数位数不统一 - 禁止在同一个动画中混用
var(--offset)和字面量50px，比如transform: translateX(var(--offset)) translateY(50px) - 不要用
calc()包裹变量再传给font-variation-settings，例如font-variation-settings: "wght" calc(var(--weight) * 1)，结果仍是字符串
JS 动态更新变量时别触发同步布局
如果用 JS 改 style.setProperty('--offset', x) 配合动画，务必避开读写交替陷阱。
立即学习“前端免费学习笔记（深入）”；
- 不要在
requestAnimationFrame回调里先读offsetTop再设变量——这会强制同步重排 - 把所有布局读取操作（
getBoundingClientRect()、clientWidth）移到动画启动前一次性缓存 - 变量更新后，确保对应元素已提升为独立合成层（检查 DevTools Layers 面板），否则 GPU 不接管，插值再准也白搭
真正卡住的从来不是变量，而是浏览器不知道你“想让它插值”。@property 是开关，类型一致性是钥匙，而 JS 更新节奏决定了这把钥匙能不能顺利插进锁孔。
