cv::imread读取失败主因是路径错误、编码/权限问题、格式不支持或大小写敏感；需用正斜杠或双反斜杠、检查img.empty()、确认解码器支持；中文路径须用系统API+imdecode/imencode绕过。
cv::imread 读取失败的常见原因
cv::imread 返回空 cv::Mat 时，不是路径写错了就是编码/权限问题。Windows 下路径反斜杠不转义（比如 "C:\test\img.jpg"）会触发转义字符，直接崩；Linux/macOS 对大小写敏感，"IMG.JPG" 找不到就静默返回空 Mat。OpenCV 默认只支持常见格式（JPEG、PNG、BMP、TIFF），读取 WebP 或 HEIC 会失败，且不报错——得先用 cv::getBuildInformation() 确认编译时是否启用了对应解码器。
- 路径统一用正斜杠或双反斜杠：
"C:/test/img.jpg"或"C:\test\img.jpg" - 读取后立刻检查：
if (img.empty()) { std::cerr - 若需读取透明通道，加标志
cv::IMREAD_UNCHANGED；默认cv::IMREAD_COLOR强制转 BGR 三通道，哪怕原图是灰度
cv::imwrite 保存不了 PNG 透明通道？
cv::imwrite 保存 PNG 时，如果源 Mat 是 CV_8UC4（带 Alpha），但保存后 Alpha 丢失，大概率是 Mat 的 channel 顺序不对。OpenCV 内部要求 BGRA 顺序（B、G、R、A），如果你手动拼了个 A 通道却放在最后（比如 BGR + A 拼成 BGR-A），而没确保第 4 通道是 Alpha，cv::imwrite 就当普通四通道数据丢弃 Alpha。
- 确保 Mat 类型为
CV_8UC4且通道顺序为 BGRA - 保存前验证：
std::cout - PNG 压缩质量通过
std::vector<int></int>控制，如{cv::IMWRITE_PNG_COMPRESSION, 9}（0–9，9 最高压缩）
中文路径在 Windows 下怎么读写
OpenCV C++ 的 cv::imread 和 cv::imwrite 原生不支持 UTF-8 或 GBK 中文路径，直接传入会失败。必须绕过 OpenCV 的文件 I/O，改用系统 API 读取字节流，再用 cv::imdecode 解码。
- Windows 下用
MultiByteToWideChar+CreateFileW读取文件到std::vector<uchar></uchar> - 然后调
cv::imdecode(buf, cv::IMREAD_COLOR) - 写入同理：用
cv::imencode(".png", img, buf)得到字节流，再用CreateFileW+WriteFile写出 - 别试图用
std::filesystem::path转字符串传给imread，它不吃这一套
读写性能和内存布局要注意什么
cv::imread 默认按 BGR 顺序加载，且像素内存是连续的（img.isContinuous() 通常为 true），但若做了 ROI 或某些变换，可能不连续——这时直接用指针遍历会越界。另外，cv::imwrite 在保存大图（如 8K TIFF）时，若未指定压缩参数，JPEG 可能因默认质量高而卡顿，PNG 则可能内存暴涨。
立即学习“C++免费学习笔记（深入）”；
- 处理前加
img = img.clone();确保内存连续 - 保存大图时限制 JPEG 质量：
{cv::IMWRITE_JPEG_QUALITY, 95}（别设 100） - TIFF 支持 16-bit，但需 Mat 类型匹配：
CV_16UC1对应单通道 16-bit，错用CV_8UC1会截断
OpenCV 的图片 I/O 表面简单，实际卡点全在路径编码、通道语义、内存连续性这些隐性约束上。尤其跨平台或处理非标格式时，别信“路径对了就能读”，多打一行 empty() 和 channels() 检查，比反复猜错误原因快得多。
