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），文件可能为空或根本没生成。
验证方法：运行 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 按“键-值”成对读取，必须严格配对：
立即学习“C++免费学习笔记（深入）”；
std::vector<int> params = {
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<char*>(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() 内部会自动转换，但手动用 libwebp 时，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，而不是盲目套用固定参数。
