最常被忽略的原因是 animation-name 和 @keyframes 名称不一致，CSS 压缩器移除空格可能导致带连字符的动画名解析错误；animation-fill-mode 被简写覆盖为 none；transform 复合值被错误拆分；媒体查询内嵌 keyframes 被剥离。
压缩工具误删关键帧或空格导致 animation-name 不匹配
动画失效最常被忽略的原因是 animation-name 和 @keyframes 名称不一致，而 CSS 压缩器（如 cssnano、clean-css）在移除空格、注释、换行时，可能把带连字符的动画名（如 slide-in）和定义体之间的空格吃掉，造成语法断裂。浏览器不会报错，只会静默跳过整个动画。
- 检查压缩后 CSS 文件中
@keyframes slide-in { ... }是否被改写成@keyframes slide-in{...}—— 看似无害，但某些旧版构建工具会进一步将-解析为减号运算符，尤其在未加引号的上下文中 - Webpack + MiniCssExtractPlugin 默认启用 cssnano，若未配置
safe: true或level: { 1: { reduceWhitespace: false } }，就容易触发此类问题 - 解决方案：对动画名统一用下划线（
slide_in）或驼峰（slideIn），避开连字符；或在@keyframes前后加空行+注释（如/* animate: slide-in */），部分压缩器会保留带注释的块
animation-fill-mode: forwards 被压缩器重置为 none
CSS 动画简写属性 animation 在压缩过程中极易丢失子属性显式值。例如原始写法 animation: fade 0.3s ease; animation-fill-mode: forwards;，压缩后可能被合并为 animation: fade 0.3s ease; —— 这会把未写出的 animation-fill-mode 强制设回默认值 none，导致动画播完立刻闪回。
- 必须把
forwards写进animation简写里：animation: fade 0.3s ease forwards;（注意末尾有空格和分号） - 避免拆成两行声明，尤其当它们不在同一 CSS 规则块内时，压缩器无法保证顺序和权重一致性
- PostCSS 插件如
postcss-discard-duplicates可能误判重复的animation-fill-mode并删除，需关闭该插件或加/* purgecss ignore */注释
transform 复合值被错误合并或截断
涉及 transform 的动画（如 scale(1.2) rotate(45deg)）在压缩时，若工具启用了“合并重复声明”或“安全优化”，可能把多值 transform 拆开、重排甚至丢弃部分函数，最终只留下一个（比如只剩 rotate()），造成视觉错乱。
- 典型表现：动画播到一半突然位移偏移、旋转中心漂移、缩放失效
- 原因在于压缩器将
transform: scale(1.2) rotate(45deg);错误解析为两条独立规则，再按字典序合并，结果变成transform: rotate(45deg); - 应对方式：在关键帧中显式写出完整
transform值，避免跨多行；使用/* no-compress */注释包裹整段@keyframes；或改用 PostCSS 插件postcss-safe-parser替代默认解析器
媒体查询嵌套动画被剥离或错位
当动画定义写在 @media 内部（如响应式入场动画），部分压缩器会因“无法静态分析条件”而直接剔除整段 @keyframes，或把 @keyframes 提到顶层但保留其内部 @media 作用域，导致动画在非目标断点下也生效或完全不注册。
立即学习“前端免费学习笔记（深入）”；
- 现象：桌面端动画正常，移动端消失；或动画在错误尺寸下意外触发
- 根本原因是 CSS 压缩规范不强制要求保留
@keyframes的嵌套上下文，多数工具默认将其扁平化 - 稳妥做法：所有
@keyframes必须定义在全局作用域（即@media外）；响应式逻辑通过切换不同animation-name或 JS 控制 class 实现，而非嵌套 keyframes
关键点在于：压缩不是“只删空格”，它会重写语法树。只要动画涉及名称匹配、复合属性拼接、或上下文依赖，就极可能被误伤。上线前务必用未压缩版本比对 DevTools 中「Styles」面板里的实际生效规则。
