核心用法
libvips-image 是基于 libvips 的 Python 图像处理工具，通过 pyvips 绑定提供高性能图像操作。核心特性包括：
- 格式支持：JPEG、PNG、WebP、AVIF、HEIC、TIFF、GIF、PDF、SVG、RAW 等300+格式
- 流式架构：按需加载像素，内存占用与图像尺寸无关，比 ImageMagick/PIL 低10-100倍
- CLI工具链：
vips_tool.py单图处理 +vips_batch.py批量处理 +run.sh/run.bat跨平台包装器
主要操作
| 类别 | 功能 |
|------|------|
| 基础变换 | resize（fit/cover/force模式）、crop、rotate、flip |
| 智能处理 | thumbnail（attention/entropy智能裁剪）、sharpen、blur |
| 格式转换 | convert（支持质量/压缩参数）、grayscale |
| 合成水印 | text/image水印、composite（多种blend模式） |
| 色彩调整 | brightness、contrast、saturation |
使用模式
- 命令行：
./run.sh vips_tool.py resize input.jpg output.jpg --width 800 - Python API：链式操作 +
access="sequential"流式读取 - 批量配置：JSON配置多操作流水线，支持多线程 workers
显著优点
1. 极致性能：libvips 采用延迟计算+流水线架构，不存储完整中间结果
2. 内存安全：大图片处理不爆内存，适合服务器批量场景
3. 生态完整：提供自动安装脚本（detect OS → install libvips → uv install pyvips）
4. 现代格式：原生支持 AVIF、HEIC 等新一代格式
潜在缺点
- 系统依赖重：需预装 libvips C 库，Windows/macOS 需处理 PATH/DYLD_LIBRARY_PATH
- 安装门槛：相比纯 Python 方案（Pillow），首次配置更复杂
- 文档分散：底层 libvips 文档与 pyvips 绑定需交叉参考
适合人群
- 需要处理 GB级大图 或 高并发批量任务 的开发者
- 对 内存占用敏感 的服务端图像服务（CDN缩略图、电商图片处理）
- 追求 WebP/AVIF现代格式 最优压缩比的前端工程团队
常规风险
| 风险点 | 说明 |
|--------|------|
| 系统库兼容性 | libvips 版本与 pyvips 需匹配，升级可能断裂 |
| 可选格式依赖 | HEIC需libheif、SVG需librsvg，未安装则静默失败 |
| 路径配置陷阱 | Windows DLL路径、macOS SIP限制DYLD变量，必须用包装脚本 |
| 质量参数误用 | AVIF/HEIC质量刻度与JPEG不同，需单独调优 |
| 并发安全 | ThreadPoolExecutor 需控制 workers 数，避免磁盘I/O瓶颈 |