前端图像压缩革命：Compressor.js 完全指南

2026-01-30 04:34:11作者：丁柯新Fawn

项目地址：https://gitcode.com/gh_mirrors/com/compressorjs

在现代Web开发中，图片优化是提升网站性能的关键环节。Compressor.js作为一款强大的JavaScript图像压缩库，通过浏览器原生的canvas.toBlob API实现高效的前端图片压缩，帮助开发者显著减少图片文件大小，提升页面加载速度。本文将全面介绍Compressor.js的核心功能、安装方法和实用技巧，让你轻松掌握前端图像压缩的精髓。

使用Compressor.js处理前后的图像对比，左侧为原始图像，右侧为压缩后效果

为什么选择Compressor.js？

Compressor.js凭借以下特性成为前端开发者的理想选择：

高效压缩：利用浏览器原生API实现图片压缩，性能优异
无损体验：在保证压缩率的同时，最大程度保留图像质量
丰富选项：提供多种压缩参数，满足不同场景需求
简单易用：简洁的API设计，快速集成到现有项目
广泛兼容：支持主流浏览器，包括Chrome、Firefox、Safari等

快速开始：安装与基本使用

安装Compressor.js

你可以通过npm轻松安装Compressor.js：

npm install compressorjs

或者直接克隆仓库进行使用：

git clone https://gitcode.com/gh_mirrors/com/compressorjs

基本使用示例

以下是一个简单的文件上传压缩示例：

<input type="file" id="file" accept="image/*">

import Compressor from 'compressorjs';

document.getElementById('file').addEventListener('change', (e) => {
  const file = e.target.files[0];
  
  if (!file) return;
  
  new Compressor(file, {
    quality: 0.6,
    success(result) {
      // 处理压缩后的图片
      console.log('压缩成功，原始大小:', file.size, '压缩后大小:', result.size);
    },
    error(err) {
      console.error('压缩失败:', err.message);
    },
  });
});

核心功能解析

灵活的压缩选项

Compressor.js提供了丰富的压缩选项，让你可以根据需求精确控制压缩效果：

质量控制：通过quality参数设置压缩质量，取值范围0-1
尺寸调整：使用maxWidth、maxHeight等参数控制图片尺寸
格式转换：支持转换图片格式，如将大尺寸PNG转为JPEG
方向校正：自动读取并应用Exif Orientation信息，修正图片方向

高级特性

图片格式智能转换

Compressor.js可以根据文件类型和大小自动转换图片格式，例如将超过5MB的PNG图片转换为JPEG格式，显著减小文件体积：

new Compressor(file, {
  convertTypes: ['image/png'],
  convertSize: 5000000, // 5MB
  success(result) {
    console.log('转换后的格式:', result.type);
  }
});

自定义绘制功能

通过beforeDraw和drew钩子函数，你可以在压缩过程中对图片进行自定义处理，如添加水印、调整色调等：

new Compressor(file, {
  beforeDraw(context, canvas) {
    // 设置灰度效果
    context.filter = 'grayscale(100%)';
  },
  drew(context, canvas) {
    // 添加水印
    context.fillStyle = '#fff';
    context.font = '20px Arial';
    context.fillText('Watermark', 10, canvas.height - 10);
  }
});

实用场景与最佳实践

上传前压缩

在文件上传前进行压缩，可以显著减少上传时间和服务器存储压力：

// 结合axios进行压缩后上传
import axios from 'axios';

new Compressor(file, {
  quality: 0.7,
  success(result) {
    const formData = new FormData();
    formData.append('file', result, result.name);
    
    axios.post('/upload', formData)
      .then(response => {
        console.log('上传成功');
      })
      .catch(error => {
        console.error('上传失败:', error);
      });
  }
});

移动端图片处理

针对移动设备拍摄的照片，Compressor.js可以自动处理方向信息并优化大小：

new Compressor(file, {
  checkOrientation: true, // 自动校正方向
  maxWidth: 1200,        // 限制最大宽度
  quality: 0.8,          // 平衡质量和大小
  success(result) {
    // 处理压缩后的图片
  }
});