<p>纯 Tailwind 无法实现波浪背景，需用 SVG 路径作为 background-image 并配合 CSS 动画；常见错误是未对 SVG 中的 # 号进行 URL 编码。</p>
用 SVG 路径 + CSS 动画实现波浪背景
纯 Tailwind 无法直接生成波浪形背景，因为 bg-gradient-to- 类只能做线性/径向渐变，不支持贝塞尔曲线。必须引入 SVG 路径作为 background-image，再用 @keyframes 动画位移它。
常见错误是直接写 bg-[url('data:image/svg+xml,...')] 却没处理 SVG 中的 #、 等字符——这些必须 URL 编码，比如 <code>%23 替换 #，%3C 替换 。
- SVG 必须是单色路径（推荐
fill="currentColor"），否则动画时颜色会卡死 - 动画目标只能是
background-position，不能动background-image本身 - 要加
bg-no-repeat bg-[length:200%_100%]，否则位移后空白区域会重复拉伸 - 容器需设固定高度（如
h-40）或min-h-，否则波浪会被压缩成一条线
在 Tailwind 配置中注册自定义波浪动画
Tailwind 不自带 animate-wave 这类类名，必须手动注册 @keyframes 并映射到 theme.extend.animation。
漏掉任一端注册（CSS 文件里写了 @keyframes wave，但 tailwind.config.js 没加进 animation 或 keyframes），animate-wave 就完全无效。
立即学习“前端免费学习笔记（深入）”；
- 帧值必须用引号包裹：
'0%'✅，0%❌ - 属性值必须是字符串：
backgroundPosition: '0% 100%'✅，backgroundPosition: 0% 100%❌ - 动画时长建议 6–8s：太短像抖动，太长失去“流动”感
- 改完配置必须重启 dev server，Tailwind 不热更 animation 类名
用 Arbitrary Value 写波浪 SVG 背景
不能依赖插件或外部 CDN，最稳的方式是把 SVG 写成内联 Data URL，并用 bg-[...] 语法嵌入。
典型失败写法：bg-[url("M0,50 Q25,20 50,50 T100,50")] —— 这根本不是合法 SVG，浏览器解析失败，背景变空白。
- 正确结构必须包含完整 SVG 标签：
bg-[url('data:image/svg+xml,%3Csvg...%3E%3C/svg%3E')] - 路径要简化：用
Q（二次贝塞尔）比C（三次）更轻量，适合高频动画 - 推荐用
fill="none" stroke="currentColor" stroke-width="2"，方便通过父级text-blue-500控制颜色 - 移动端注意
background-size：大屏设200%_100%，小屏可试300%_100%加强起伏感
防止波浪动画和内容层叠异常
波浪背景本质是 background-image，但它会触发新的 stacking context，尤其当父容器用了 mix-blend-mode 或 isolation: isolate 时，文字可能被“吃掉”。
- 给内容层加
relative z-10，确保它始终在波浪之上 - 别对波浪容器设
opacity，这会让整个动画变灰变慢；如需半透，改用bg-black/20叠在波浪上 - 如果波浪和图片/视频同框，务必检查
background-blend-mode是否误启用——它需要 ≥2 个背景层才生效，单波浪层+空背景不会 blend - SSR 场景下，Data URL 中的双引号容易和服务端模板引擎冲突，建议提前 encode 后存为常量变量
