必须验证WebP魔数再解码，否则WebPDecodeBGRA可能静默失败；需检查前12字节为"RIFF" + 4字节长度 + "WEBP"；解码格式依目标容器选BGRA或RGBA；注意行跨距差异，须逐行memcpy而非整块拷贝。
WebP解码前必须验证魔数，否则WebPDecodeBGRA会静默失败
libwebp本身不校验输入数据是否为合法WebP——它只管解码，传入任意二进制数据都可能返回非空指针，但像素内容完全不可用。真实项目中常见错误是直接把文件全读进来就调用解码函数，结果WebPDecodeBGRA返回了指针，CImage::Create也成功了，最后保存的BMP却是花屏或全黑。
必须在解码前确认前12字节符合WebP魔数：0x52 0x49 0x46 0x46 ?? ?? ?? ?? 0x57 0x45 0x42 0x50（即"RIFF" + 4字节大小 + "WEBP"）。注意中间4字节是LE格式的文件总长，可忽略；重点比对首尾8字节。
- 用
std::ifstream file(path, std::ios::binary)打开，file.read(buf, 12)后立刻检查file.gcount() == 12 - 缓冲区必须是
unsigned char buf[12]，避免char符号扩展导致0x52被误判为负值 - 比对用
memcmp(buf, "\x52\x49\x46\x46\x00\x00\x00\x00\x57\x45\x42\x50", 12)，中间4字节填0不影响匹配
解码输出格式选WebPDecodeBGRA还是WebPDecodeRGBA？取决于目标容器
WebPDecodeBGRA和WebPDecodeRGBA返回的内存布局完全不同：前者是B-G-R-A排列，后者是R-G-B-A。C++里绝大多数Windows图像容器（如CImage、GDI+ Bitmap）默认按BGRA顺序排布像素，直接拷贝最省事；而OpenCV的cv::Mat默认是BGR，cv::imwrite保存PNG/JPEG时也按BGR解释。
- 若目标是
CImage且用Create(w, h, 32)，选WebPDecodeBGRA，逐行memcpy即可，无需通道重排 - 若后续要喂给OpenCV做处理，选
WebPDecodeRGBA再用cv::cvtColor(mat, mat, cv::COLOR_RGBA2BGRA)，比手动循环换序更可靠 -
WebPDecodeRGB不带Alpha，遇到含透明通道的WebP会丢弃Alpha信息，且返回指针可能为nullptr——别图省事绕过Alpha检查
行跨距（stride）不一致导致图像错位，必须按行拷贝而非整块memcpy
WebPDecodeBGRA返回的像素指针指向的是连续内存块，pitch（每行字节数）固定为width * 4；但CImage内部位图缓冲区的pitch由Windows GDI决定，可能因内存对齐向上取整（如宽1921像素 → pitch = 1924×4 = 7696字节）。直接memcpy(dst, src, width * height * 4)会导致后续几行全部偏移。
立即学习“C++免费学习笔记（深入）”；
- 正确做法是循环
for (int y = 0; y - 获取
CImage每行首地址：BYTE* line = static_cast<byte>(image.GetBits()) + y * image.GetPitch()</byte> - 获取解码数据每行首地址：
BYTE* src_line = pixels + y * width * 4（因为libwebp保证无padding） - 别依赖
image.GetPitch() == width * 4——32位图在某些系统上仍可能对齐到16字节边界
释放内存必须用WebPFree，不能用delete[]或free
libwebp内部用malloc分配解码缓冲区，但它可能在不同平台链接到不同的CRT实现（如MSVCRT vs UCRT），混用释放函数会导致堆损坏。Windows下尤其明显：用free释放WebPDecodeBGRA返回的指针，在VS2017+UCRT环境下大概率触发HEAP CORRUPTION断言。
- 唯一安全方式：
WebPFree(pixels)，其中pixels是WebPDecodeBGRA返回的指针 - 不要尝试用
std::unique_ptr配delete[]——libwebp没提供自定义deleter接口 - 如果封装成类，析构函数里必须先调
WebPFree再置空指针，避免重复释放
真正麻烦的不是解码本身，而是WebP文件头校验和内存对齐这两个点——它们不出错时不显山露水，一出错就是花屏、崩溃、内存越界，且很难复现。建议把魔数检查和行拷贝逻辑抽成独立函数，每次解码前强制走一遍。
