Animate.css v4.1.1 的完整文件大约 88KB(未压缩),压缩后约 7KB,Gzip 后约 3KB。对于一个包含 80+ 个动画的库来说,这个体积其实不大。但问题在于:大多数项目只用到其中 5-10 个动画。
一个典型的电商项目可能只需要:fadeInUp(列表入场)、zoomIn(弹窗)、fadeOut(Toast消失)、pulse(加载指示)、shakeX(表单错误)。5 个动画的实际 CSS 可能只有 2KB,但完整引入了 7KB。
如果你的项目对加载体积非常敏感(比如 Lighthouse 评分要上 95+),按需加载就有价值了。
Animate.css v4 基于 PostCSS 构建,源码在 node_modules/animate.css/source/ 目录。每个动画是一个独立的 CSS 文件:
animate.css/source/ ├── animate.css # 主入口(包含所有动画) ├── animations/ │ ├── fading_entrances/ │ │ ├── _fadeIn.css │ │ ├── _fadeInUp.css │ │ └── ... │ ├── bouncing_entrances/ │ │ ├── _bounceIn.css │ │ └── ... │ └── ... ├── base/ │ └── _base.css # animate__animated 基础类 └── utilities/ ├── _delays.css ├── _duration.css └── _repeat.css
只引入需要的动画:
// 只引入 fadeInUp 和 zoomIn import 'animate.css/source/base/_base.css'; import 'animate.css/source/animations/fading_entrances/_fadeInUp.css'; import 'animate.css/source/animations/zoom_entrances/_zoomIn.css'; import 'animate.css/source/utilities/_duration.css'; import 'animate.css/source/utilities/_delays.css';
这会只打包这三个动画的 @keyframes 和类名,加上基础类和工具类。最终输出可能只有 1-2KB。
如果你的项目使用 Tailwind CSS 或其他原子化 CSS 框架,很可能已经配置了 PurgeCSS(或 Tailwind 内置的 JIT 编译器)。PurgeCSS 可以扫描你的 HTML/JS/模板文件,只保留实际使用的 CSS 类。
配置 PostCSS:
// postcss.config.js const purgecss = require('@fullhuman/postcss-purgecss'); module.exports = { plugins: [ purgecss({ content: [ './src/**/*.html', './src/**/*.js', './src/**/*.jsx', './src/**/*.vue', './src/**/*.ts', './src/**/*.tsx' ], css: [ './node_modules/animate.css/animate.css' ], // Animate.css 的 @keyframes 名不带前缀 // 需要特殊处理 defaultExtractor: function(content) { const classes = content.match(/animate__[a-zA-Z0-9_-]+/g) || []; return classes; }, // 保留 @keyframes(即使类名被移除,keyframes 本身可能被其他方式引用) keyframes: true }) ] };
注意 defaultExtractor:PurgeCSS 默认的正则不一定能匹配 Animate.css 的双下划线命名。需要自定义提取规则。
如果 PurgeCSS 配置复杂,可以自己写一个简单的构建脚本:
// scripts/build-animate.js const fs = require('fs'); const path = require('path'); // 配置:你项目需要的动画列表 const neededAnimations = [ 'fadeIn', 'fadeInUp', 'fadeInDown', 'fadeOut', 'fadeOutUp', 'zoomIn', 'zoomOut', 'bounceIn', 'shakeX', 'pulse', 'slideInLeft', 'slideInRight' ]; const baseDir = path.join(__dirname, '../node_modules/animate.css/source'); const outputPath = path.join(__dirname, '../src/assets/animate-custom.css'); // 读取基础类 const baseCss = fs.readFileSync(path.join(baseDir, 'base/_base.css'), 'utf-8'); const delayCss = fs.readFileSync(path.join(baseDir, 'utilities/_delays.css'), 'utf-8'); const durationCss = fs.readFileSync(path.join(baseDir, 'utilities/_duration.css'), 'utf-8'); const repeatCss = fs.readFileSync(path.join(baseDir, 'utilities/_repeat.css'), 'utf-8'); // 读取所需动画 let animationsCss = ''; neededAnimations.forEach(function(name) { // 在所有动画目录中查找 const animDirs = fs.readdirSync(path.join(baseDir, 'animations'), { withFileTypes: true }) .filter(d => d.isDirectory()) .map(d => d.name); for (const dir of animDirs) { const filePath = path.join(baseDir, 'animations', dir, '_' + name + '.css'); if (fs.existsSync(filePath)) { animationsCss += fs.readFileSync(filePath, 'utf-8') + '\n'; break; } } }); // 合并输出 const output = `/* 自定义 Animate.css 构建文件 */\n/* 包含动画: ${neededAnimations.join(', ')} */\n\n` + baseCss + '\n' + animationsCss + '\n' + delayCss + '\n' + durationCss + '\n' + repeatCss; fs.writeFileSync(outputPath, output); console.log(`输出: ${outputPath} (${(output.length / 1024).toFixed(1)} KB)`);
运行:
node scripts/build-animate.js
然后在项目中引入自定义文件:
import './assets/animate-custom.css';
如果你通过 npm 引入 Animate.css,Webpack 5 默认支持 CSS Modules 的 tree shaking。但标准 CSS import(import 'animate.css')不会被 tree shaking——整个文件都会被包含。
要实现 tree shaking,需要把 Animate.css 当作 ES Module 引入。Animate.css v4 的 package.json 中设置了 "sideEffects": true,告诉打包工具这个包有副作用(CSS 的 @import 就是一种副作用),不应被 tree shaking。
如果你确实想 tree shaking,可以在 package.json 中覆盖:
{ "sideEffects": ["./source/**/*.css"] }
但更稳妥的做法还是用上面介绍的"自定义构建"或"PurgeCSS"方案。

Vite 使用 esbuild 做开发、Rollup 做生产构建。由于 Animate.css 是纯 CSS,Vite 的 CSS 处理流程可以直接用 PostCSS 插件:
// vite.config.js import { defineConfig } from 'vite'; import purgecss from '@fullhuman/postcss-purgecss'; export default defineConfig({ css: { postcss: { plugins: [ process.env.NODE_ENV === 'production' ? purgecss({ content: ['./index.html', './src/**/*.{js,ts,jsx,tsx,vue}'], css: ['./node_modules/animate.css/**/*.css'], defaultExtractor: function(content) { return content.match(/animate__[a-zA-Z0-9_-]+/g) || []; } }) : undefined ] } } });
开发环境保留完整 Animate.css(方便调试),生产环境用 PurgeCSS 精简。这是最实用的方案。
如果使用 CDN 引入 Animate.css,没有构建步骤,按需加载就需要其他方案:
// 动态加载特定动画的 CSS(如果服务端支持按需返回) async function loadAnimation(name) { if (!document.querySelector(`link[href*="${name}"]`)) { var link = document.createElement('link'); link.rel = 'stylesheet'; link.href = `/cdn/animate/${name}.css`; document.head.appendChild(link); await new Promise(resolve => link.onload = resolve); } }
这种方式需要服务端或 CDN 支持。国内 BootCDN、jsDelivr 等公共 CDN 不支持这种粒度的按需加载。