更新记录

1.0.0（2025-10-13） 下载此版本

• [新增] compressImage 方法

平台兼容性

uni-app(3.6.10)

image-utils

uni-app 图片处理工具库，支持多平台图片压缩功能。

功能特性

• 多端兼容：H5、App、小程序

安装

# 通过 uni_modules 安装
# 将 image-utils 文件夹放入项目的 uni_modules 目录中

API 文档

compressImage(src, options?)

压缩图片的主要方法。

参数

• src (string): 图片路径，必填
• options (CompressOptions): 压缩选项，可选

CompressOptions

返回值

返回 Promise<CompressResult>

CompressResult

使用示例

基础压缩

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);
      console.log('压缩成功:', result);
      console.log(`原始大小: ${result.originalSize}KB`);
      console.log(`压缩后: ${result.size}KB`);
      console.log(`压缩比: ${(result.ratio * 100).toFixed(1)}%`);
    } catch (error) {
      console.error('压缩失败:', error);
    }
  },
});

自定义压缩参数

const result = await compressImage(filePath, {
  quality: 0.8, // 压缩质量 80%
  maxWidth: 1200, // 最大宽度 1200px
  maxHeight: 800, // 最大高度 800px
  format: 'jpg', // 输出格式
  : (progress) => {
    // 显示压缩进度
    console.log(`压缩进度: ${progress}%`);
  },
});

质量预设

平台差异

注意事项

1. 文件路径: 确保传入的图片路径有效且可访问
2. 内存管理: 处理大图片时注意内存使用，建议分批处理
3. 格式支持: 不同平台对图片格式的支持可能有差异
4. 权限要求: 某些平台可能需要文件访问权限