CSShake需手动添加shake类名才能触发抖动动画，常见错误是仅引入CSS文件却未在HTML中绑定对应class。
抖动动画不触发？检查 class 是否正确绑定
CSShake 不是自动扫描页面加动画的库，必须手动给元素加上对应 shake 类名（或其变体），否则什么都不会发生。常见错误是只引入了 CSS 文件，但忘了在 HTML 里写 class="shake"。
使用场景：按钮悬停反馈、表单校验失败提示、操作失败后的视觉强调。
-
shake是最基础版本，循环一次后停止 - 需要持续抖动？用
shake-loop（注意性能开销） - 移动端触摸后抖动失效？补上
cursor: pointer或监听touchstart触发重绘 - 抖动幅度太小？CSShake 默认用
transform: translate()，若父容器有overflow: hidden，可能裁掉动画边缘——改用shake-slow或自定义 keyframes 更稳妥
引入后样式冲突？优先级和作用域问题
CSShake 的动画依赖 @keyframes shake 和大量 .shake 相关类，如果项目用了 Tailwind、Bootstrap 或自定义 reset，容易被覆盖或重置。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 确保 CSShake 的
csshake.min.css在其他 CSS 之后加载（尤其在中靠后位置） - 避免用
!important覆盖它——改用更具体的选择器，比如.my-form .error-input.shake - 如果你用的是构建工具（Vite/Webpack），别直接
@import它的 SCSS；改用编译后 CSS，或手动提取 keyframes 到项目中统一管理 - 发现抖动卡顿？检查是否同时启用了
will-change: transform——CSShake 没默认加，但加了反而可能触发过多图层合成，得看设备性能
想自定义抖动方向或频率？别改源码，复用 keyframes
CSShake 提供了多个预设类（如 shake-horizontal、shake-constant），但不支持运行时传参。真要微调，得自己抄一份 @keyframes 并改 transform 值。
为什么这样做：
- 源码里的 keyframes 名称固定为
shake，浏览器缓存后改文件名也不生效，必须改内容 - 水平抖动比垂直抖动更常用，因为人眼对横向位移更敏感；但
shake-vertical在表单错误提示中其实更自然（模拟“摇头”拒绝） - 频率太高（如
0.1s一帧）在低端安卓机上会掉帧；建议保持在0.2s–0.3s区间 - 示例：复制
@keyframes shake-horizontal，把translateX(-5px)改成translateX(-8px)，再另起一个类.shake-aggressive绑定它
React/Vue 里动态控制抖动？别用 classList 切换，用 key 强制重渲染
在框架中频繁增删 shake 类，容易因 DOM 复用导致动画不触发（尤其是 Vue 的 v-if 或 React 的条件渲染）。CSS 动画依赖 class 存在时的“进入”时机，不是纯 CSS 切换就能重播。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- React：用
key控制，比如<div key="{shaking" date.now : classname="shake"> <li>Vue：配合 <code>:key+v-show，避免v-if卸载节点；或者用$nextTick手动触发 reflow - 不要用
setTimeout清除 class 后立刻加回去——浏览器没来得及重绘，动画就丢了；至少间隔一帧（requestAnimationFrame） - SSR 场景下，服务端渲染时 class 已存在，首屏抖动不会播；需在
useEffect或mounted钩子中延迟添加
真正难的不是让元素抖起来，而是判断什么时候该抖、抖多久、抖完要不要留个视觉余量——比如表单错误后抖一下，紧接着滚动到错误字段，这个衔接稍不注意，用户就会觉得“卡”或者“没反应”。
