CSS变量本身不触发重绘，需通过transform等属性实际变化并配合transition或@keyframes才能驱动动画；常见失效原因包括变量无单位、未定义、值非法或未在CSS中真正引用。
为什么直接用 style.setProperty 设置 CSS 变量不触发粒子动画
因为 CSS 变量本身不会触发重绘，只有当它被用于会触发布局或绘制的属性（比如 transform、opacity）且这些属性值实际变化时，动画才生效。常见错误是只改了 --x、--y 变量，但没在 @keyframes 或 transition 中真正读取它们——比如写成 transform: translate(var(--x), var(--y)); 却忘了加单位，或者变量初始值是空字符串/非法值，导致整个声明被浏览器忽略。
- 确保每个粒子元素都有独立的
style作用域（不能共用同一组setProperty调用） -
var(--x)必须带单位（如var(--x)px或提前在变量里包含单位，如--x: 120px） - 动画需依赖
transition: transform 0.6s ease-out或@keyframes中显式使用transform: translate(var(--x), var(--y))
如何用 JS 为每个粒子分配唯一坐标变量并批量触发
关键不是“一次性设完再统一动”，而是先初始化所有粒子的起始变量（比如都指向中心点），再用 requestAnimationFrame 逐帧更新目标变量值，并让 CSS 的 transition 自动补间。否则直接设终值会导致瞬间跳变。
- 给每个粒子加唯一 class（如
particle），避免全局污染：<div class="particle" style="--x: 0px; --y: 0px;"></div>
- JS 初始化阶段：用
getBoundingClientRect()算出容器中心，对每个.particle元素调用el.style.setProperty('--x', `${dx}px`)和--y - 不要用
setTimeout批量设终值；改用el.style.transition = 'transform 0.8s cubic-bezier(0.2, 0.8, 0.4, 1)'+ 立即设新变量，让浏览器自动插值
transform: translate(var(--x), var(--y)) 为什么有时不生效
最常踩的坑是单位缺失或变量未定义。CSS 变量若未声明或值非法，var() 回退到初始值（如 0），但 translate(0, 0) 是合法的——所以你可能根本看不出问题，只是所有粒子都堆在左上角。
- 检查浏览器 DevTools 的 Computed 面板，看
transform是否解析为none或matrix(1, 0, 0, 1, 0, 0)，这说明var(--x)返回了无效值 - 务必在 :root 或元素自身上声明默认值：
style="--x: 0px; --y: 0px;"，不能只靠 JS 后设 - 避免在
transform中混用单位：不要translate(var(--x)px, var(--y)px)，而应让变量自带单位，或统一用calc(var(--x) * 1px)（仅限支持 calc 的环境）
性能瓶颈在哪？为什么粒子一多就卡
每帧读写 100+ 个元素的 style.setProperty 不是主要问题，真正拖慢的是强制同步布局（layout thrashing）：当你在循环里连续读取 offsetLeft 又写 setProperty，浏览器被迫反复重排。
立即学习“前端免费学习笔记（深入）”；
- 把所有读操作（如容器尺寸、随机角度）提前批量做完，写操作集中到最后一个循环
- 用
will-change: transform提前提示浏览器该元素要动，但别滥用——只加在粒子元素上，且动画结束后移除 - 超过 200 粒子时，改用
transform: translate3d(...)触发 GPU 加速，对应变量也要改成--x3d、--y3d并拼成translate3d(var(--x3d), var(--y3d), 0)
粒子动画的复杂度不在“怎么动”，而在“怎么不动声色地动”——变量得有单位，过渡得有声明，JS 得避开重排，GPU 得适时接管。漏掉其中任一环，看起来就像没动。
