OpenCV 4.5+ 原生支持 WebP 写入，但需编译时启用 libwebp；若 cv::getBuildInformation() 显示 webp: NO，则 imwrite 会静默失败；正确参数仅支持 IMWRITE_WEBP_QUALITY 或 IMWRITE_WEBP_LOSSLESS 成对使用。
OpenCV 4.5+ 直接支持 WebP 写入，但需确认编译时启用了 libwebp
OpenCV 从 4.5.0 版本开始，原生支持用 cv::imwrite() 输出 WebP 格式。不过，有个前提——编译 OpenCV 时必须链接了 libwebp，而且版本不能低于 1.0。很多预编译包（比如通过 pip 安装的 opencv-python）默认不包含 WebP 支持。这时候调用 cv::imwrite("out.webp", img) 会静默失败——返回 false，文件可能直接为空，或者根本没生成。
怎么知道自己当前的 OpenCV 有没有 WebP 支持？很简单，运行 cv::getBuildInformation()，在输出里找 webp 字段。如果显示的是 YES，那恭喜你；如果是 NO，那后面所有保存尝试都会失效。
- Linux/macOS 下自己编译 OpenCV 时，确保安装了
libwebp-dev（Ubuntu）或webp（macOS via Homebrew），并开启-D WITH_WEBP=ON - Windows 用户若用 vcpkg，执行
vcpkg install opencv[webp]；若用 conan，选带webp=True的选项 - 不想重编译？跳到下一节，那里有临时绕过方案
cv::imwrite() 保存 WebP 的正确参数写法
cv::imwrite() 对 WebP 格式只接受两个可选参数：IMWRITE_WEBP_QUALITY（质量，0–100）和 IMWRITE_WEBP_LOSSLESS（是否无损）。注意，它不支持像 JPEG 那样的 IMWRITE_JPEG_QUALITY 或 PNG 的压缩级别。
很多人容易在这里踩坑——传错了参数名，比如误用了 IMWRITE_JPEG_QUALITY，或者把参数数组写成了 {IMWRITE_WEBP_QUALITY, 80, IMWRITE_WEBP_LOSSLESS, 1} 这种错序。OpenCV 是按“键-值”成对读取的，必须严格配对：
std::vectorparams = { cv::IMWRITE_WEBP_QUALITY, 90, // 质量 90（有损） // cv::IMWRITE_WEBP_LOSSLESS, 1 // 若启用此行，则忽略 QUALITY，强制无损 }; cv::imwrite("output.webp", img, params);
- 质量值
75左右是体积与画质的较好平衡点；>95体积激增，提升有限 - 启用
IMWRITE_WEBP_LOSSLESS时，IMWRITE_WEBP_QUALITY被忽略，文件扩展名仍为.webp，但内部编码方式不同 - Alpha 通道会被保留（WebP 支持 RGBA），无需额外处理
OpenCV 不支持 WebP 时的替代方案：用 libwebp 手动编码
如果 OpenCV 编译时不带 WebP，最轻量、最可控的方式是直接调用 libwebp API 将 cv::Mat 数据转为 WebP 字节流。这要求你链接 libwebp（不是 OpenCV），但避免了整个 OpenCV 重建。
关键步骤：把 cv::Mat 转成 RGB/BGR 数据指针 → 调用 WebPEncodeRGB() 或 WebPEncodeBGR() → 写入文件。注意 OpenCV 默认是 BGR，而 WebPEncodeRGB() 期望 RGB，所以要么转换通道，要么用对应函数：
// 假设 img 是 CV_8UC3 类型的 BGR 图像
uint8_t* data = img.data;
int stride = img.step; // 注意：step 可能大于 width*3（内存对齐）
int result_size;
uint8_t* webp_data = WebPEncodeBGR(data, img.cols, img.rows, stride,
80, &result_size); // 80 是质量
if (webp_data) {
std::ofstream f("out.webp", std::ios::binary);
f.write(reinterpret_cast(webp_data), result_size);
f.close();
WebPFree(webp_data);
}
- 务必检查
webp_data是否非空，编码失败时返回nullptr stride必须用img.step，不能简单写img.cols * 3，否则跨行数据错位- 若图像含 Alpha，需用
WebPEncodeRGBA()并确保cv::Mat是CV_8UC4
容易被忽略的细节：色彩空间与 alpha 处理
WebP 对色彩空间敏感。OpenCV 的 cv::Mat 默认是 BGR，而 WebP 规范以 RGB 为基准。用 cv::imwrite() 时不用担心，它内部已经做了转换。但手动编码时就得小心了——BGR 和 RGB 一旦混用，颜色就会出错，比如蓝色变红色。
- 用
cv::imwrite()时无需操心，它已封装转换逻辑 - 手动编码时：BGR 图像必须用
WebPEncodeBGR()或先转 RGB（cv::cvtColor(img, rgb, cv::COLOR_BGR2RGB)）再用WebPEncodeRGB() - Alpha 通道：OpenCV 的
CV_8UC4Mat 会被cv::imwrite()正确识别为 RGBA；手动编码必须用WebPEncodeRGBA()，且确保第 4 通道是 0–255 的 Alpha 值（不是预乘 Alpha） - 灰度图（
CV_8UC1）可直接保存，WebP 会自动按单通道编码，体积比 PNG 小约 20–30%
WebP 的实际压缩效果高度依赖图像内容和参数组合，建议对关键图像做 A/B 测试——同一张图分别用 IMWRITE_WEBP_QUALITY=75 和 IMWRITE_WEBP_LOSSLESS=1 保存，对比体积与 PSNR，而不是盲目套用固定参数。
