stroke-dashoffset动画卡顿的主因是路径长度未对齐，需用pathLength强制标准化单位；设pathLength="100"后统一按100计算偏移，禁用getTotalLength()，否则混用会导致节奏错乱。
为什么stroke-dashoffset动画会卡顿或跳变
直接对stroke-dashoffset加transition却看不到平滑变化，常见原因不是代码写错，而是路径长度没对齐。浏览器按像素渲染时，若getTotalLength()返回值和实际绘制长度不一致（比如 SVG 缩放、transform: scale()、响应式宽高导致 viewBox 被挤压），那哪怕你设了 transition: stroke-dashoffset 0.5s linear，也会出现“一帧到下一帧”的步进感——因为每帧计算的 offset 值本身就不连续。
用pathLength强制标准化路径单位
pathLength 是 SVG <path> 的原生属性，它不改变图形形状，只告诉浏览器：“请把这条路径的总长度当作指定数值来处理”。设置后，getTotalLength() 返回的就是你写的值，stroke-dasharray 和 stroke-dashoffset 的计算就完全可控。
实操建议：
- 在 SVG 路径上显式添加
pathLength="100"（推荐取整百数，便于百分比计算） - JS 中不再调用
path.getTotalLength()，统一按100计算偏移量：初始设stroke-dashoffset="100"，动画终点设为0 - CSS transition 可直接写
transition: stroke-dashoffset 0.6s linear，无需强制重排 - 如果路径需响应式缩放，
pathLength仍生效——它绑定的是路径数据本身，不受容器尺寸影响
pathLength 和 getTotalLength() 混用会出问题
一旦设了 pathLength，再调用 getTotalLength() 就返回该值，而非真实几何长度。这点容易被忽略，尤其当项目里既有老代码依赖自动测量、又有新逻辑用 pathLength 时。
立即学习“前端免费学习笔记（深入）”；
常见错误现象：
- 动画突然变快或变慢，且不同路径节奏不一致
- 同一 SVG 中部分路径动、部分不动，查 DOM 发现有的写了
pathLength、有的没写 - resize 后动画错位，但没报错——其实是旧逻辑还在用
getTotalLength()算缩放后的长度，而新逻辑按固定pathLength运行
解决方法：全量统一。要么全部删掉 pathLength 改用动态测量 + resize 监听；要么全部加上 pathLength，并删除所有 getTotalLength() 调用。
真正需要变形动画时，pathLength 不起作用
pathLength 只解决“绘制进度”类动画的平滑性，对路径形状变化（比如直线变曲线、M→C 命令结构变更）完全无效。这种场景下，d 属性仍是不可过渡的字符串，浏览器无法插值。
如果你看到的“不平滑”其实是两个不同 d 值之间硬切，那：
- 别试图用
pathLength修复，它不参与d解析 - 改用 JS 插值库（如
anime.js的pathEl支持）或手写requestAnimationFrame逐帧生成中间d - 或者退一步：用
transform移动/缩放整个<path>，视觉上模拟变形，更轻量也更可控
最易被忽略的一点：很多开发者花半天调 stroke-dashoffset 的 timing-function，却没检查 pathLength 是否全局一致——路径动画的“平滑”，往往卡在第一步的单位标准化上。
