offset-path 动画不动主因是浏览器兼容性差：firefox 完全不支持，safari 仅支持 path() 而非 url(#id)，且需用 @supports 检测；chrome 中抖动多因路径曲率突变，应平滑贝塞尔控制；匀速位移须用 linear 缓动+精准路径长度计算，避免 transition 驱动 offset-distance。
offset-path 为什么动画不动？浏览器兼容性是硬门槛
offset-path 是 CSS Motion Path 模块的核心属性，但它在主流浏览器中支持度不均衡。Chrome 75+、Edge 79+ 和 Safari 15.4+ 支持，Firefox 完全不支持（截至 2024 年中），且 Safari 仅支持 path() 函数，不支持 url(#myPath) 引用 SVG <path></path> 元素。
- 动画没反应？先检查
browser.userAgent，用@supports (offset-path: path(""))做特性检测，别直接上 - Safari 中写
offset-path: url(#route)会静默失败，必须改用offset-path: path("M0,0 L100,50 Q150,100 200,50") - Chrome 中若配合
offset-rotate: auto出现抖动，大概率是路径曲率突变，建议用贝塞尔控制点平滑过渡
offset-path + offset-distance 实现匀速位移的关键写法
位移动画本质是让元素沿路径“走”，靠的是 offset-distance 的变化。它不是时间函数，而是路径长度的归一化比例（0–1 或带单位如 50px），所以要实现视觉上的匀速，得确保动画本身用 linear 缓动，且路径定义无隐式变速陷阱。
- 路径中避免大量短直线拼接（如
path("M0,0 L1,0 L2,0 ...")），这会让浏览器计算总长度时累积浮点误差，导致offset-distance: 1卡在终点前几像素 - 推荐用 SVG
getPathSegList()或getTotalLength()预算路径长度，再换算成百分比控制：比如总长 320px，想走到 200px 处，写offset-distance: calc(200 / 320 * 100%) - 不要用
transition直接驱动offset-distance——它不触发重排优化，动画卡顿明显；改用@keyframes+animation-timing-function: linear
offset-rotate 自动对齐失效的三个常见原因
offset-rotate 设为 auto 时，元素应自动旋转以匹配路径切线方向。但实际常出现“歪着走”或“原地打转”。
- 路径起点处曲率为 0（比如从直线段开始），浏览器无法确定初始切线方向，
offset-rotate: auto可能 fallback 到 0deg；加offset-rotate: 0deg显式初始化可缓解 - 使用
path()时，如果命令里混用相对/绝对坐标（如"M0,0 l50,0 Q100,50 150,0"），部分浏览器解析切线出错；统一用大写字母（M,L,Q）更稳妥 - 元素自身有
transform: rotate()会与offset-rotate叠加，造成角度叠加混乱；动画期间禁用其他transform旋转操作
替代方案：当 offset-path 不可用时，用 SVG 更可靠如果项目需兼容 Firefox 或旧版 Safari，硬上 offset-path 只会增加兜底成本。SVG 原生的 <animatemotion></animatemotion> 支持所有现代浏览器，且路径复用、暂停控制、事件回调都更成熟。
立即学习“前端免费学习笔记（深入）”；
- 把路径抽成独立
<path id="track"></path>，然后在目标元素外层套 <g></g>，内嵌 <animatemotion href="https://www.php.cn/link/c7e274f2fe950fbc3d82d36fb2f245f8" path="..." begin="0s" dur="3s" repeatcount="indefinite"></animatemotion>
- 注意：CSS 中设置的
offset-* 属性和 SVG <animatemotion></animatemotion> 互斥，同时存在时后者优先，前者被忽略
- 如果必须用 JS 控制进度，别读
offset-distance（FF 不支持），改用 getPointAtLength() 手动计算坐标 + transform: translate() 模拟，再用 Math.atan2(dy, dx) 算朝向
路径跟随不是加个属性就完事的事——浏览器实现差异、路径几何质量、与其他 transform 的耦合，每一步都容易掉进静默失败的坑里。最省心的做法，是先用 @supports 切出支持路径动画的用户，再把不支持的降级到 requestAnimationFrame + getPointAtLength 手动驱动，而不是指望一套代码跑通所有场景。
如果项目需兼容 Firefox 或旧版 Safari，硬上 offset-path 只会增加兜底成本。SVG 原生的 <animatemotion></animatemotion> 支持所有现代浏览器，且路径复用、暂停控制、事件回调都更成熟。
立即学习“前端免费学习笔记（深入）”；
- 把路径抽成独立
<path id="track"></path>，然后在目标元素外层套<g></g>，内嵌<animatemotion href="https://www.php.cn/link/c7e274f2fe950fbc3d82d36fb2f245f8" path="..." begin="0s" dur="3s" repeatcount="indefinite"></animatemotion> - 注意：CSS 中设置的
offset-*属性和 SVG<animatemotion></animatemotion>互斥，同时存在时后者优先，前者被忽略 - 如果必须用 JS 控制进度，别读
offset-distance（FF 不支持），改用getPointAtLength()手动计算坐标 +transform: translate()模拟，再用Math.atan2(dy, dx)算朝向
路径跟随不是加个属性就完事的事——浏览器实现差异、路径几何质量、与其他 transform 的耦合，每一步都容易掉进静默失败的坑里。最省心的做法，是先用 @supports 切出支持路径动画的用户，再把不支持的降级到 requestAnimationFrame + getPointAtLength 手动驱动，而不是指望一套代码跑通所有场景。
