必须配合SVG <circle> 和动态周长计算，因 stroke-dashoffset 是与周长强绑定的绝对偏移量，写死数值会导致缩放、响应式或半径变化时进度错位；默认起点在3点钟方向，需用 transform="rotate(-90 50 50)" 校正至12点钟方向。
直接用 stroke-dashoffset 做环形进度条加载动画，必须配合 SVG <circle> 和动态周长计算，纯 CSS（比如 transform: rotate() 或 clip-path）在安卓 WebView、旧版 Safari 和部分高 DPI 设备上会错位、卡顿或完全不生效。
为什么 stroke-dashoffset 不能单独写死值
stroke-dashoffset 是“向后偏移”实线起点的长度，不是百分比。它和圆周长强绑定：偏移量从周长减到 0，才对应进度从 0% 到 100%。写死一个数值（比如 157）看似省事，但一旦 r 改了、viewBox 缩放、或需要响应式适配，进度立刻错位。
- 必须先算周长：
const circumference = 2 * Math.PI * radius（例如r="45"→circumference ≈ 282.74） - 0% 对应
stroke-dashoffset = circumference（整圈隐藏） - 60% 对应
stroke-dashoffset = circumference * (1 - 0.6)（即circumference * 0.4） - 别漏负号逻辑：值越小，显示越长；值越大，越空
如何让进度从顶部开始而不是右侧
SVG <circle> 默认绘制起点在 3 点钟方向（正右方），但人眼习惯 12 点钟为 0% 起点。不修正会导致进度“顺时针甩一圈再开始”，视觉反直觉。
- 加
transform="rotate(-90 50 50)"（假设圆心是cx="50" cy="50"） - 注意旋转中心必须和
cx/cy一致，否则圆会平移 - 不要用
transform: rotate(-90deg)这类 CSS 写法——它作用于整个元素盒，不是路径原点 - 如果用 JS 动态设置，记得用
setAttribute('transform', 'rotate(-90 50 50)')，而非style.transform
transition 在哪些场景会失效
CSS 的 transition: stroke-dashoffset 0.3s ease 在多数现代浏览器里能用，但在安卓 4.4–6.x 的 WebView、部分 iOS 12 以下 Safari 中会被忽略——动画直接跳变，没有过渡。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
立即学习“前端免费学习笔记（深入）”；
- 稳妥做法：JS 控制帧级更新，用
requestAnimationFrame插值，而非依赖 CSS 过渡 - 若坚持用 CSS transition，必须把声明写在内联
style上（如<circle style="transition: stroke-dashoffset 0.3s ease">），避免被外部 CSS 类覆盖 - 别对
stroke-dasharray做 transition——它只在初始渲染时起作用，运行中改它不会触发重绘动画 - 动画结束时，确保最终
stroke-dashoffset值精确等于目标值（浮点误差会导致最后一帧轻微抖动）
背景环和前景环怎么分层才不出错
环形进度条需要两个独立 <circle>：一个静态背景环（track），一个动态前景环（progress）。混用同一个 <circle> 改颜色或宽度，会导致描边对齐错位、两端接缝明显。
- 背景环：只设
stroke、stroke-width、fill="none"，不设stroke-dasharray或transform - 前景环：设
stroke-dasharray="circumference"、stroke-dashoffset="circumference"、transform="rotate(-90 50 50)"，并加stroke-linecap="round"消除尖角 - 两者的
cx/cy/r必须完全一致，否则会出现同心但偏移的“双环”现象 - 文字居中建议用
<text x="50%" y="50%" dominant-baseline="middle" text-anchor="middle">，别用绝对像素
最易被忽略的是：所有尺寸（r、cx、cy）必须基于 viewBox="0 0 100 100" 的相对坐标系，而不是固定像素。否则缩放时 stroke-dashoffset 和旋转中心就不同步，进度环会在容器边缘“漂移”。
