GIF 的 Quality 参数为何不生效

在 govips 中调整 GifExportParams.Quality，输出 GIF 的体积和观感可能都没有明显变化。先确认导出是否走 libvips 原生 gifsave；这个路径并不使用 JPEG 式的 quality 参数。

症状

调整 GifExportParams.Quality 值，输出 GIF 的体积基本不变。
期望通过类似 JPEG 的 quality 语义控制 GIF 画质，但效果无效。

根因

libvips 的原生 gifsave 只有这些参数：dither、effort、bitdepth、interlace 等，并没有 quality。它没有 JPEG 那种“质量档位”的概念——GIF 是调色板格式，画面由有限颜色数决定。

GifExportParams.Quality 之所以存在，是因为旧路径：libvips 版本较旧（低于 8.12）时，gifsave 会回退到 magicksave（由 ImageMagick 提供），而那是少数能识别 quality 的路径。在走原生 gifsave 时，该字段不生效——官方也因此仅补了注释，没有拆掉这个参数。

改用有效的参数

要控制 GIF 输出，请使用原生 gifsave 支持的参数，而不是 quality。govips 的 GifExportParams 实际暴露的是：

Effort：压缩努力程度（影响文件体积与编码耗时）。
Bitdepth：颜色位深（影响颜色数与体积）。
Dither：抖动，影响画质表现，不直接等于体积。

（v2.19.0 源码里对这些字段的注释直接写明：Quality 只在 vips < 8.12 走 magicksave 回退时使用，原生 gifsave 忽略它。）

排查步骤

确认你的 libvips 是否走原生 gifsave（较新版本会）。
用 Effort / Bitdepth 观察体积变化，验证参数确实生效。
不要在原生 gifsave 路径下把 Quality 当作体积控制开关。

受影响版本与边界

你在目标 libvips 版本下期望 quality 生效——对该版本的原生 gifsave 而言这不是 bug。
GIF 有损画质期望与 JPEG 一致——GIF 是调色板格式，语义本就不同。
本页按 govips v2.19.0 与 libvips 8.17.3 的原生 gifsave 路径复核；更早版本的 ImageMagick 回退路径不同。

来源

不同 libvips 版本可能选择不同的 GIF 保存路径；应以目标环境实际注册的操作为准。