更新记录

1.1.0（2026-07-01） 下载此版本

• 多格式支持：JPEG / PNG / WebP（基于 libvips 的 sharp 引擎）
• 智能缩放：支持设置最大宽高，超出自动等比缩放
• 自动备份：压缩前自动生成 .bak 备份（可关闭）
• 批量压缩：右键文件夹递归压缩所有图片
• 详细统计：显示原始大小、压缩后大小、节省比例

1.0.0（2026-06-18） 下载此版本

1.0.0更新日志，首次发布

平台兼容性

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后，卸载时需手动卸载，详细教程参考：如何手动卸载插件

图片压缩插件 (Image Compress) v1.1

简单实用的 HBuilderX 图片压缩插件，支持 JPEG / PNG / WebP 格式，可显著减小图片体积。

功能特性

• 多格式支持：JPEG / PNG / WebP（基于 libvips 的 sharp 引擎）
• 智能缩放：支持设置最大宽高，超出自动等比缩放
• 自动备份：压缩前自动生成 .bak 备份（可关闭）
• 批量压缩：右键文件夹递归压缩所有图片
• 对比预览：单图压缩后可一键对比原图 vs 压缩图
• 详细统计：显示原始大小、压缩后大小、节省比例

使用方法

安装依赖

cd /d/HBuilderX/plugins/xpi-img-compress
npm install

压缩图片

打开 HBuilderX，右键图片文件 → 选「压缩图片」

• 单图压缩后弹窗会多出一个「对比预览」按钮，点击会在 HBuilderX 中并排打开原图（.bak）和压缩图

批量压缩

右键文件夹 → 选「批量压缩文件夹」

• 自动递归扫描所有图片（JPG/PNG/WebP）
• 跳过 node_modules 和隐藏目录
• 弹窗显示总节省空间和失败列表

配置项

工具 → 插件配置 → 图片压缩设置：

开发工作流

修改源码后 → 双击 sync.bat → HBuilderX 里 Ctrl+Shift+P → Reload Window

⚠️ 注意：HBuilderX 加载的是 D:\HBuilderX\plugins\ 下的副本，源码修改后需要手动同步。

技术栈

• Node.js + sharp（libvips 引擎，业界最快的图片处理库）
• HBuilderX 扩展 API

版本历史

• v1.1：新增 WebP 支持、批量压缩、自动备份、对比预览（用 sharp 替换 jimp）
• v1.0：初始版本，仅支持 JPG/PNG（基于 jimp）