直接改stroke-dashoffset不如用CSS变量灵活，因硬编码数值绑定固定尺寸，而CSS变量支持动态适配、主题切换和运行时调整，但需显式声明transition: --offset、补单位、按viewBox缩放修正，并确保路径规范与浏览器兼容。
为什么直接改stroke-dashoffset不如用CSS变量灵活
硬编码数值会让动画绑定死在某个尺寸上：比如stroke-dashoffset: 120只对周长120px的SVG有效，换一个尺寸就得重算、重写。而CSS变量把“偏移量”抽成可复用的配置项，同一套动画逻辑能适配不同大小的SVG，也方便主题切换或运行时动态调整。
常见错误是以为stroke-dashoffset: var(--offset)加个transition就能动——其实旧版浏览器（Chrome 110前、Firefox 112前）根本不支持自定义属性触发重绘，动画会卡住不动。
- 必须显式声明
transition: --offset 0.4s ease，不能只写transition: stroke-dashoffset - 变量值要带单位（如
--offset: 120），并在使用处用calc(var(--offset) * 1px)补单位 - 若SVG有
viewBox缩放，getTotalLength()返回的是原始坐标系长度，变量需按缩放比动态修正
stroke-dasharray设成var(--length)后动画不匀速？检查路径本身
描边动画卡顿或跳变，往往不是CSS写错了，而是SVG路径有问题。比如用<rect></rect>加rx/ry圆角生成的边框，getTotalLength()计算出的周长和实际视觉路径长度不一致——浏览器按几何积分算，但圆角段的曲线采样点密度会影响dash节奏。
更稳妥的做法是用<path></path>显式写出闭合路径，避免依赖<rect></rect>或<circle></circle>的隐式渲染逻辑。
立即学习“前端免费学习笔记（深入）”；
- 导出SVG时禁用“简化锚点”或“优化路径”，某些工具（如AI）会插入冗余贝塞尔控制点，导致
getTotalLength()返回0或异常值 - 调试时直接在控制台执行
document.querySelector('path').getTotalLength()，确认返回值合理 - 响应式场景下，
resize事件中必须重新获取getTotalLength()并更新--length和--offset
如何让stroke颜色也跟着变量走
描边动画常被误认为“只动线不动色”，其实stroke本身支持CSS过渡，但需要两个前提：一是显式声明transition: stroke 0.3s，二是目标值必须是确定的颜色格式（#3b82f6、hsl(200, 100%, 50%)等），不能用currentcolor或未定义变量兜底。
用变量驱动颜色最简方式是：stroke: var(--stroke-color) + :root { --stroke-color: #3b82f6 }，再配合transition: stroke。注意Safari 15.4之前不支持stroke过渡，会直接跳变。
- 不要在
@keyframes里写stroke: var(--stroke-color)——它只取初始值，不会随变量变化重播 - 若同时动画
stroke-dashoffset和stroke，建议统一用@keyframes管理，避免transition触发时机错位 - 多个SVG共用一套颜色变量时，确保
:root或父元素上已声明该变量，否则var(--x)会退为默认值（通常是transparent）
Next.js里用CSS变量控制SVG动画要注意什么
Next.js默认把SVG转成React组件，这意味着内联style或className都能生效，但原始SVG里的fill/stroke内联属性会覆盖CSS变量——这是最容易忽略的一环。
例如导入的icon.svg里写着<path fill="#000"></path>，那无论你怎么设--fill-color都没用，浏览器优先级是内联样式 > CSS变量 > 外部样式表。
- 编辑SVG源文件，删掉所有
fill、stroke、style内联属性，只留class或id - 在CSS模块里用
.icon path { fill: var(--fill-color) }，而不是直接作用于.icon - 动态主题切换时，别只改
:root变量，还要确保组件已挂载完成——SSR阶段JS不可用，变量可能未生效，需用useEffect或useState兜底
真正难的不是写变量，是让变量在缩放、重绘、跨浏览器、服务端渲染这些边界条件下依然可靠。每次改--offset前，先确认getTotalLength()有没有被缩放扭曲；每次换--stroke-color，先看Safari控制台报不报transition unsupported。
