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）。很多人直接拿去显示或运算，结果程序崩溃或黑屏，却没意识到读图根本没成功。

C++ 算法竞赛自动化测试数据生成与校验框架

根据原题生成新题面、验证器及完整测试数据，自动套用 testlib 模板，用于用户要求生成测试数据时。

下载

• 必须写判断：

  cv::Mat img = cv::imread("path.jpg");
  if (img.empty()) {
      std::cerr 

• 不要依赖 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，且不提示原因。

• 检查是否启用了 WebP 支持：cv::getBuildInformation() 输出里搜 webp，看到 YES 才行
• CMake 编译时要加 -D WITH_WEBP=ON，并确保系统已安装 libwebp 开发包
• Windows 预编译包（如 opencv-python）通常自带，但 C++ 官方 Win pack 默认不含，得自己编译或换用 vcpkg 安装：vcpkg install opencv[webp]

路径、空 Mat 判断、色彩空间、编解码支持——这四点漏掉任意一个，cv::imread 就会静默失效。尤其要注意 Windows 路径编码和 OpenCV 的 BGR 默认行为，它们不是“高级技巧”，而是日常必踩的坑。

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！