安装与环境检查

系统里的 libvips 和语言包不是同一个安装单元。pyvips 和 govips 通常需要系统里存在可发现的 libvips；sharp 的预构建包则自带一份 libvips。只记录语言绑定（binding）的包版本，不足以复现编码器和格式支持。

本手册验证环境的版本基线

2026-10-12 在 Fedora Linux 43 上执行了版本命令。下表是本手册验证环境记录到的结果，用于对照各示例的输出。

组件	实测版本	实际加载的 libvips
vips CLI	8.17.3	8.17.3
pyvips	3.2.0	8.17.3
sharp	0.35.5	8.18.7（包内自带）
Go	1.27.0	不自带 libvips；已执行示例使用 govips v2.19.0，并链接上面的系统 libvips 8.17.3
Node.js	24.14.1	见 sharp
Python	3.14.5	见 pyvips

govips 没有单独的“打印版本”命令。已执行示例在输出元数据中记录了 govips v2.19.0 与系统 libvips 8.17.3 的组合。

下面两条命令来自 libvips 官方安装说明，复核日期 2026-10-12。

Ubuntu 或 Debian 的开发包：

sudo apt-get update
sudo apt-get install libvips-dev

macOS 上 Homebrew 的安装命令：

brew install vips

安装后用 vips --version 查看 CLI 版本。发行版仓库里的 libvips 可能旧于 8.17.3；版本不同时，请先确认目标操作在当前版本中是否可用。

go get github.com/davidbyttow/govips/v2@v2.19.0

govips 使用 CGO。编译器找不到头文件时，先检查 pkg-config --modversion vips 是否与打算使用的系统库一致。

npm install sharp@0.35.5
node -e "import('sharp').then(({default:s}) => console.log(s.versions))"

请同时记录输出里的 sharp 和 vips 版本。0.35.5 的预构建包在本次核对中自带 libvips 8.18.7。

python -m pip install pyvips==3.2.0
python -c "import pyvips; print(pyvips.__version__, pyvips.version(0), pyvips.version(1), pyvips.version(2))"