当前位置：首页 > news >正文

前端图片压缩方案

news 2026/6/11 19:35:17

在Vue 3项目中压缩图片，可以有效优化图片体积，提升加载性能和用户体验。以下是几种常用方案和核心代码示例。

下表概述了主要的压缩方案，你可以根据项目需求选择：

方案	特点	适用场景
compressorjs	功能丰富，配置灵活，支持通过质量或尺寸压缩	需要精细控制压缩参数的项目
browser-image-compression	支持WebWorker，防止界面卡顿，可限制文件大小或尺寸	需压缩大图片且避免阻塞主线程
image-conversion	支持按指定大小（如KB）进行压缩	需要精确控制输出文件大小的场景
Canvas API手动压缩	不依赖第三方库，可控性高	简单压缩需求或希望减少依赖的项目
uni-app项目	使用专用的`image-utils`插件	开发多端应用（如小程序、App）

🛠️ 使用第三方库压缩

以下是几种常用库的具体使用方法。

1. Compressor.js

Compressor.js是一款配置灵活的图片压缩库。

安装：

npm install compressorjs

在Vue组件中使用：

<template><input type="file" @change="handleImageUpload" accept="image/*" />
</template><script setup>
import Compressor from 'compressorjs';const handleImageUpload = (event) => {const file = event.target.files[0];if (!file) return;new Compressor(file, {quality: 0.6, // 压缩质量 (0-1)success(result) {// 处理压缩后的文件，例如上传到服务器const compressedFile = new File([result], file.name, { type: result.type });console.log('压缩成功', compressedFile);},error(err) {console.error('压缩失败:', err.message);},});
};
</script>

2. browser-image-compression

此库支持WebWorker，压缩大图片时不易阻塞界面交互。

安装：

npm install browser-image-compression

在Vue组件中使用：

<template><input type="file" @change="handleImageUpload" accept="image/*" />
</template><script setup>
import imageCompression from 'browser-image-compression';const handleImageUpload = async (event) => {const file = event.target.files[0];if (!file) return;const options = {maxSizeMB: 1, // 最大文件大小（MB）maxWidthOrHeight: 1920, // 最大宽或高useWebWorker: true, // 使用WebWorker，避免阻塞界面initialQuality: 0.8, // 初始压缩质量（0-1），但browser-image-compression选项名可能为`initialQuality`，请注意文档};try {const compressedFile = await imageCompression(file, options);console.log('压缩成功', compressedFile);// 注意：compressedFile是一个Blob或File对象，可直接用于上传} catch (error) {console.error('压缩失败:', error);}
};
</script>

3. image-conversion

此库的一个特色是支持按指定大小（如KB）进行压缩。

安装：

npm install image-conversion

在Vue组件中使用：

<template><input type="file" @change="handleFileChange" accept="image/*"><img v-if="compressedImage" :src="compressedImage" alt="Compressed Image" />
</template><script setup>
import { ref } from 'vue';
import imageConversion from 'image-conversion';const compressedImage = ref(null);const handleFileChange = async (event) => {const file = event.target.files[0];if (!file) return;try {// 压缩到大约200KBconst compressedFile = await imageConversion.compressAccurately(file, {size: 200, // 目标大小，单位KBaccuracy: 0.9 // 压缩精度});compressedImage.value = URL.createObjectURL(compressedFile);console.log('压缩成功', compressedFile);} catch (error) {console.error('Error compressing image:', error);}
};
</script>

📝 手动使用Canvas压缩

如果不希望引入第三方库，可以使用HTML5的Canvas API手动压缩图片。这种方法可控性高，但需要自己处理细节。

<template><input type="file" @change="handleImageUpload" accept="image/*" /><canvas ref="canvas" style="display: none;"></canvas>
</template><script setup>
import { ref } from 'vue';const canvas = ref(null);const handleImageUpload = (event) => {const file = event.target.files[0];if (!file) return;const reader = new FileReader();reader.onload = (e) => {const img = new Image();img.onload = () => {const ctx = canvas.value.getContext('2d');// 设置最大宽高const maxWidth = 800;const maxHeight = 600;let { width, height } = img;// 等比例缩放计算if (width > height) {if (width > maxWidth) {height *= maxWidth / width;width = maxWidth;}} else {if (height > maxHeight) {width *= maxHeight / height;height = maxHeight;}}// 设置Canvas尺寸并绘制图片canvas.value.width = width;canvas.value.height = height;ctx.drawImage(img, 0, 0, width, height);// 转换为Blob（压缩后的图片）canvas.value.toBlob((blob) => {const compressedFile = new File([blob], file.name, {type: 'image/jpeg', // 输出格式，可根据需要调整});console.log('压缩成功', compressedFile);},'image/jpeg', // 输出格式0.7 // 输出质量（0-1）);};img.src = e.target.result;};reader.readAsDataURL(file);
};
</script>

🌐 针对uni-app项目

如果你在使用uni-app开发多端应用，可以使用其官方生态中的image-utils插件。

安装与使用：

在项目的uni_modules目录中安装image-utils插件。
在项目中引入并使用：

<script setup>
import { compressImage } from '@/uni_modules/image-utils';// 选择图片并压缩
uni.chooseImage({count: 1,success: async (res) => {const filePath = res.tempFilePaths[0];try {const result = await compressImage(filePath, {quality: 0.8, // 压缩质量maxWidth: 1200, // 最大宽度maxHeight: 800, // 最大高度});console.log('压缩成功', result.tempFilePath);console.log(`原始大小: ${result.originalSize}KB, 压缩后: ${result.size}KB`);} catch (error) {console.error('压缩失败:', error);}},
});
</script>

💡 实践建议

图片格式选择：JPEG格式通常更适合压缩照片类图片，而PNG格式更适合需要保留透明度的图片。需要注意的是，compressorjs对PNG图片的压缩，如果通过quality参数可能效果不佳，有时需要通过调整尺寸（size）进行压缩。
合理设置参数：压缩质量（quality）通常在 0.6 到 0.8 之间能在体积和质量间取得较好平衡。同时设置maxWidth和maxHeight可以防止图片尺寸过大。
用户体验：压缩是耗时操作，较大图片尤其如此。建议提供加载指示器（如loading动画）告知用户操作进度。browser-image-compression等库支持进度回调，可用于更新UI。
兼容性处理：对于不支持某些API（如Canvas、FileReader）的旧版浏览器，需要有回退方案（如直接上传原图）或友好提示。