OpenCV读取多张图片返回空Mat的常见原因包括路径含中文、相对路径解析错误、图片格式不被支持（如WebP）、空格及特殊字符敏感；调试需先用绝对路径和std::filesystem::exists验证文件存在，再检查mat.empty()。
OpenCV 读取多张图片时，为什么 cv::imread 返回空 Mat？
常见原因是路径含中文、相对路径解析错误或图片格式不被支持（如 WebP 未编译解码器）。cv::imread 默认只支持 BMP、JPEG、PNG、TIFF、HDR 等基础格式，且对路径中空格和特殊字符敏感。调试时先用绝对路径 + std::filesystem::exists 验证文件存在，再检查 mat.empty()。
- Windows 下路径用正斜杠
"C:/img/1.jpg"或双反斜杠"C:\img\1.jpg"，避免单反斜杠转义 - Linux/macOS 注意大小写，
"IMG.JPG"和"img.jpg"是不同文件 - 若需读 WebP/HEIC，得自己编译 OpenCV 并启用对应后端（如 libwebp），否则静默失败
垂直拼接时，如何统一宽度并处理尺寸不一致？
直接 cv::vconcat 会报错 "all input arrays must have the same number of rows" —— 实际上它要求所有 Mat 的列数（即宽度）相同。所以必须先缩放或裁剪。
- 最常用策略：以第一张图宽度为基准，其余图按比例缩放高度，保持宽高比：
cv::resize(mat, mat, cv::Size(target_width, static_cast<int>(mat.rows * (double)target_width / mat.cols)))</int> - 若要保留原始分辨率、用黑边补全，用
cv::copyMakeBorder，注意cv::BORDER_CONSTANT和cv::Scalar(0,0,0)表示黑色 - 灰度图与彩色图混用会触发断言失败，拼接前统一转换：
cv::cvtColor(mat, mat, cv::COLOR_GRAY2BGR)
用 cv::vconcat 拼长图，为什么内存暴涨甚至崩溃？
cv::vconcat 是浅拷贝友好的，但若传入的 Mat 来自 std::vector<:mat></:mat> 且反复 push_back 大图，容器扩容可能触发多次深拷贝；更关键的是，拼接后的大图若超 2GB（尤其 4K×N 场景），32 位 OpenCV 或某些 Windows GDI 限制会直接 std::bad_alloc。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 预分配目标 Mat：
cv::Mat result(total_height, width, CV_8UC3)，再用cv::Rect定位每张图写入区域，避免中间临时对象 - 分块拼接：每次拼 10 张，保存中间结果，再读回继续，防止峰值内存过高
- 确认 OpenCV 构建时启用了
OPENCV_ENABLE_NONFREE不影响此操作，但 64 位编译是硬性前提
保存超长图时，cv::imwrite 报错 “could not find a writer for the specified extension”
这不是扩展名问题，而是 OpenCV 默认只支持 PNG/JPEG/TIFF 写入，而 PNG 对超长图（>65535 像素高）有规范限制，部分实现会静默截断或失败；JPEG 则不支持 >65535 × 65535 分辨率。
立即学习“C++免费学习笔记（深入）”；
- 优先选
".tiff"：支持大尺寸，无压缩损失，cv::imwrite("out.tiff", result)即可 - 若必须用 PNG，加参数
std::vector<int>{cv::IMWRITE_PNG_COMPRESSION, 0}</int>关闭压缩，减少写入失败概率 - 导出为 WebP（需 OpenCV ≥ 4.5.4 且编译了 libwebp）：
cv::imwrite("out.webp", result, {cv::IMWRITE_WEBP_QUALITY, 90})，体积小且支持大图
实际拼接逻辑本身很薄：读图 → 统一宽度 → 按行复制像素 → 保存。真正卡点永远在路径、内存、格式这三块，而不是算法。
