cv::imread读图失败主因是Windows下中文/空格路径不被fopen支持，返回空Mat而不报错；须检查img.empty()，临时解法用英文路径，根本解法改用std::ifstream+cv::imdecode。
cv::imread 读不到图，先检查路径和编码
Windows 下用中文路径或带空格的路径，cv::imread 默认会失败，不是 OpenCV 有 bug，而是它底层调用的是 C 标准库的 fopen，不支持 UTF-8 路径（即使你源文件保存为 UTF-8）。常见现象是返回空 cv::Mat，但不报错。
- 临时解法：把图片放到纯英文无空格路径下，比如
"D:/test/lena.jpg" - 真正解法：改用
cv::imread(cv::utils::fs::glob配合std::filesystem做路径预处理，或改用cv::imread的 Unicode 友好替代方案——先用std::ifstream读二进制数据到std::vector<uchar></uchar>，再用cv::imdecode - 注意
cv::imread第二个参数默认是cv::IMREAD_COLOR，如果想保留 alpha 通道，得显式传cv::IMREAD_UNCHANGED
cv::Mat 为空？立刻检查 return 值
cv::imread 不抛异常，失败时只返回空 cv::Mat（即 mat.empty() == true）。很多人直接拿去显示或运算，结果程序崩溃或黑屏，却没意识到读图根本没成功。
- 必须写判断：
cv::Mat img = cv::imread("path.jpg"); if (img.empty()) { std::cerr << "Failed to load image!" << std::endl; return -1; } - 不要依赖 IDE 的“当前工作目录”——VS 默认是项目目录，Clion 默认是可执行文件所在目录，建议用绝对路径调试，确认后再切回相对路径
- Linux/macOS 下注意大小写：
"lena.JPG"和"lena.jpg"是不同文件
读出来的图是黑的或颜色不对？查色彩空间和位深
OpenCV 默认按 BGR 顺序存储三通道图像，而大多数显示库（如 Qt、SDL）和人眼习惯是 RGB。如果你直接把 cv::Mat 丢给 OpenGL 纹理或 Qt QLabel，大概率颜色发紫或发绿。
- 显示前转 RGB：
cv::cvtColor(img, img_rgb, cv::COLOR_BGR2RGB) - 灰度图读取：加参数
cv::IMREAD_GRAYSCALE，否则即使原图是灰度，cv::imread仍可能返回三通道 BGR（内部填充相同值） - 16 位图（如 TIFF）会被自动缩放为 8 位，若需原始深度，要用
cv::IMREAD_UNCHANGED并确认图像类型是CV_16UC1或CV_16UC3
OpenCV 4.8+ 在 Windows 上读 WebP 失败？缺 codec 插件
新版 OpenCV 默认关闭第三方解码器（尤其是 WebP、JPEG2000），cv::imread 对 .webp 文件返回空 cv::Mat，且不提示原因。
立即学习“C++免费学习笔记（深入）”；
- 检查是否启用了 WebP 支持：
cv::getBuildInformation()输出里搜webp，看到YES才行 - CMake 编译时要加
-D WITH_WEBP=ON，并确保系统已安装 libwebp 开发包 - Windows 预编译包（如 opencv-python）通常自带，但 C++ 官方 Win pack 默认不含，得自己编译或换用 vcpkg 安装：
vcpkg install opencv[webp]
cv::imread 就会静默失效。尤其要注意 Windows 路径编码和 OpenCV 的 BGR 默认行为，它们不是“高级技巧”，而是日常必踩的坑。 
