VIPS：如何将ActiveStorage附件转换为WebP或AVIF格式

问题根源 #

你当前的代码里，WebP转换未明确指定输出格式，AVIF的参数位置也存在错误，再加上可能依赖的图像处理库缺少对应格式支持，导致始终输出原JPG格式。

修复步骤 #

1. 确认图像处理依赖支持目标格式

   • 如果使用MiniMagick/ImageMagick：
     • WebP需要系统安装libwebp库
     • AVIF需要ImageMagick版本≥7.0.10-68，且系统安装libavif库
   • 可通过运行magick identify -list format | grep -E "(WEBP|AVIF)"验证是否支持

2. 修正WebP转换代码
   必须在变体参数里明确指定format: :webp，否则会沿用原图片格式：

   <%= image_tag @attachment.variant(
     resize_and_pad: [300, 300, background: [255]],
     format: :webp,
     saver: { strip: true, quality: 75, lossless: false, alpha_q: 85, reduction_effort: 6, smart_subsample: true }
   ).processed %>
   

3. 修正AVIF转换代码
   format是变体的顶级参数，不能放在saver配置里，正确写法：

   <%= image_tag @attachment.variant(
     format: :avif,
     saver: { quality: 75, lossless: false }
   ).processed %>
   

4. 清理旧变体并验证

   • 删除storage目录下已生成的缓存变体文件
   • 重启服务器后重新访问页面，查看图片URL后缀是否为.webp或.avif，也可直接检查存储目录里的文件格式

内容的提问来源于stack exchange，提问作者Ben