SVG圆环进度条通过stroke-dasharray设为周长、stroke-dashoffset动态偏移实现，需配合rotate(-90)对齐顶部、viewBox响应式缩放，并仅对stroke-dashoffset做CSS过渡动画。
SVG <circle></circle> 的 stroke-dasharray 和 stroke-dashoffset 是核心
圆环进度条不是靠 JS 动画帧驱动的“伪进度”，而是用 SVG 路径描边的“裁剪+偏移”机制实现的。关键在两个属性：stroke-dasharray 控制虚线长度（这里设为整个圆周长），stroke-dashoffset 控制起点偏移量。进度 = 0% 时偏移量 = 周长，看起来完全不可见；进度 = 100% 时偏移量 = 0，整圈显示。
圆周长必须精确计算：2 * Math.PI * r。别硬写 250 或 314 —— 一旦 r 改了，进度就会错位。
常见错误现象：
– 进度动不了，或只动一半 → stroke-dasharray 没设成周长，或 stroke-dashoffset 初始值不对
– 圆环顺时针转但进度从顶部开始 → transform="rotate(-90)" 没加，SVG 默认 0° 在正右方
– 线条粗细不一致、边缘模糊 → 忘了设 stroke-linecap="round"
实操建议：
– 用 <g transform="rotate(-90)"></g> 包住 <circle></circle>，让 0° 对齐顶部
– r 设为固定值（如 50），cx/cy 对齐中心（如 60）
– stroke-dasharray 统一设为 "314.16"（即 2 * 3.1416 * 50），保持可读性
– JS 更新时只改 stroke-dashoffset：偏移量 = 周长 × (1 − 进度/100)
立即学习“前端免费学习笔记（深入）”；
用 CSS transition 实现平滑进度动画
纯 CSS 就能做缓动动画，不需要 requestAnimationFrame。关键是把 stroke-dashoffset 设为可过渡属性，并加 transition 声明。
注意点：
– 必须在 SVG 元素上直接写 style="transition: stroke-dashoffset 0.3s ease-out;"，CSS 类里写可能被内联样式覆盖
– 不要对 stroke-dasharray 做 transition —— 它是离散值，浏览器无法插值
– 如果用 JS 批量更新多个环，避免高频 setAttribute，先存 offset 值，最后统一触发重排
示例（内联 style）：
<circle cx="60" cy="60" r="50" fill="none" stroke="#e0e0e0" stroke-width="8" stroke-dasharray="314.16" stroke-dashoffset="314.16" style="transition: stroke-dashoffset 0.3s ease-out;" />
JS 动态更新 stroke-dashoffset 的安全写法
直接操作 DOM 属性比操作 style 更稳定，尤其在 SSR 或 Shadow DOM 场景下。
推荐方式：
– 用 circleEl.setAttribute('stroke-dashoffset', offsetValue)
– offsetValue 必须是字符串或数字，不能是带单位的（如 "200px"）
– 计算前检查 circleEl 是否存在，避免 Cannot set property 'setAttribute' of null
– 进度值要做边界处理：Math.max(0, Math.min(100, percent))
容易踩的坑：
– 用 circleEl.style.strokeDashoffset = xxx → 在 Firefox 下可能不生效（SVG 属性优先级问题）
– 把 percent 当整数用却没 parseInt → "50%" 导致 NaN
– 多次调用更新函数未防抖，导致视觉卡顿（尤其配合滚动触发时）
适配响应式：用 viewBox 替代固定宽高
硬写 width="120" height="120" 会导致缩放失真或溢出。真正响应式的做法是删掉 width/height，只留 viewBox="0 0 120 120"，再用 CSS 控制容器尺寸。
这样做的好处：
– 圆环自动等比缩放，线条粗细（stroke-width）也随容器变化（如果设为相对单位如 stroke-width="8%"）
– 配合 max-width: 100% 可嵌入任意宽度的卡片或弹窗
– 不需要监听 resize 重新计算 r 和周长
注意：viewBox 中的数值必须和内部 cx/cy/r 对齐。例如 viewBox="0 0 120 120"，则 cx="60" cy="60" r="50" 才居中且不越界。
实际项目里最常被忽略的是 rotate(-90) 和 viewBox 的组合 —— 看似小细节，缺一个就导致进度方向反了或在移动端炸开。
