术语、错误信息与资料索引

想快速查一个词、一句报错，或找一个权威出处，从这里开始。本页按三部分组织：术语、错误信息索引、外部资料。

高频术语

术语	定义
libvips	C 编写的高性能图像处理库，特点是在内存中通过 lazily 计算与线程池处理超大图像。
ImageRef	govips 里持有 libvips `VipsImage*` 的 cgo 句柄；必须手动 `Close()`。
multi-page / pages	把 GIF、动图、PDF、多页 TIFF 建模为多页；`n=1` 只取第一页，`n=-1` 取全部。
NumPages	govips 加载参数，控制读取多少页。
toilet-roll	动图缩放后帧错位的现象描述（旋转/缩放时未正确处理多页）。
ICC profile	色彩特性文件，用于跨设备/色彩空间一致的色彩再现。
CMYK	青品黄黑四色油墨分量，不是 RGB 那样的直接颜色。
StripMetadata	导出时是否去除元数据；默认为 false。
EXIF / IPTC	嵌入图像的文字元数据（如相机信息、版权）。
alpha	决定透明度的第四通道。
side-effect import	导入以触发 `init()` 注册的包，例如 `_ "image/png"`。
comparison-pending	另一 binding 尚未经共享 Runner 验证比较，默认行为不作断言。

报错	含义与排查
`image: unknown format`	Go 侧缺少 side-effect import，或 libvips 无 native loader。→ missing-codec
`xxx_save not found`	libvips 过旧/未编译该 native save op。→ missing-codec，install-failures
`bad grid geometry`	动图整图操作在未加载全部页时产生。→ animation-multi-page
`Wrong JPEG library version`	编译期与运行期 libjpeg 版本冲突。→ install-failures
段错误 / SIGSEGV	并发共享 ImageRef 或过早关闭源对象。→ concurrency-safety
RSS 持续增长	未 Close 的 ImageRef、碎片化或缓存预热。→ memory-leak
`GIF Quality 无效`	原生 gifsave 无 quality 参数。→ gif-quality
WebP 丢 ICC	已知边界，可能需规避。→ colour-shift