WebP解码必须链接libwebp库，否则WebPDecodeRGB等函数报undefined reference；需通过包管理器安装开发包、CMake中find_package并target_link_libraries；解码前必调WebPGetInfo验证数据合法性并获取宽高与alpha信息；解码后用WebPFree释放内存；注意RGB输出顺序与OpenCV的BGR差异；动画支持需启用demux模块且需手动实现帧合成逻辑。
WebP解码必须链接libwebp，否则WebPDecodeRGB等函数根本找不到
很多初学者在调用WebPDecodeRGB或WebPDecodeRGBA时直接报undefined reference to 'WebPDecodeRGB'——这不是代码写错了，是根本没链接库。Linux/macOS下需显式加-lwebp（注意顺序：源文件在前，-lwebp在后）；Windows用MSVC则要额外确认是否把webp.lib加入链接器输入，并把头文件路径加进包含目录。
别指望#include <webp/decode.h>就能自动拉来实现——头文件只声明，解码逻辑全在动态/静态库里。
- Ubuntu安装：运行
sudo apt install libwebp-dev（含头文件+静态/动态库） - macOS用Homebrew：
brew install webp - CMake中必须写：
find_package(webp REQUIRED)+target_link_libraries(your_target PRIVATE webp)
解码前务必检查WebPGetInfo返回值，否则可能传入损坏数据导致崩溃
WebPGetInfo不是可选步骤，它验证输入buffer是否为合法WebP、读取宽高、判断是否含alpha通道。跳过这步直接喂给WebPDecodeRGBA，遇到不完整或伪造的WebP数据（比如开头几个字节被截断），libwebp内部可能越界读取或触发断言失败。
典型错误写法：uint8_t* rgba = WebPDecodeRGBA(data, size, &width, &height);——万一data是空指针或size为0，这个调用会直接返回nullptr，但没人检查。
立即学习“C++免费学习笔记（深入）”；
- 安全流程：先调
WebPGetInfo(data, size, &width, &height)，返回0表示无效数据 - 若需alpha，再根据
WebPGetInfo返回的has_alpha标志决定调WebPDecodeRGBA还是WebPDecodeRGB - 解码后记得用
WebPFree释放返回的像素内存，不能用free()或delete[]
默认解码输出是BGR顺序？不，WebPDecodeRGB输出RGB，但OpenCV等库常按BGR处理
WebPDecodeRGB输出的是标准RGB排列（R在前，B在后），而OpenCV的cv::Mat默认通道顺序是BGR。如果直接把WebPDecodeRGB结果塞进cv::Mat(height, width, CV_8UC3, pixels)再显示，图像颜色会严重偏色（比如人脸发青）。
这不是libwebp的bug，是通道约定差异。解决方式取决于你后续怎么用：
- 喂给OpenGL/Vulkan：保持RGB，纹理采样时不用改
- 喂给OpenCV：用
cv::cvtColor(mat, mat, cv::COLOR_RGB2BGR)翻转通道 - 自己处理像素：注意索引——
pixels[i*3+0]是R，i*3+1是G，i*3+2是B
想支持WebP动画？libwebp的demux模块必须手动启用，且不提供帧合成逻辑
默认编译的libwebp只带decode模块，WebPAnimDecoder相关接口根本不存在。要解析WebP动画，得确认安装时启用了demux（Ubuntu的libwebp-dev默认含demux，但某些精简版SDK可能不含）。
即便有了libwebp-demux，它也只负责拆出每帧的原始数据和时间戳，**不合成alpha、不处理帧叠加模式（blend method）、不帮你做延迟等待**。你得自己实现：读WebPAnimFrame、按dispose_method清背景、按blend_method混合当前帧、用duration控制播放节奏。
一句话：WebP动画解析是半成品，libwebp扔给你砖，砌墙得自己动手。
