用 std::ifstream 读取图片仅获原始字节，非可处理图像；需 cv::imread() 或 stb_image 解码才能获取宽高、通道等信息，且必须检查 mat.empty() 等有效性。
用 std::ifstream 读取图片文件只是拿到二进制字节，不是图像数据
很多人以为用 std::ifstream 以 std::ios::binary 模式打开 "image.jpg" 就算“读取了图片”，其实这只是把文件原始字节拷进内存，cv::Mat 或 stb_image 完全不认识这些字节。你得到的是一个 std::vector<uint8_t></uint8_t>，但没解码，没有宽高、通道数、像素值——它还不是图像。
- 直接读取适合做文件校验、拼接、网络传输等底层操作，不适用于后续绘图或计算
- 若后续要用 OpenCV 处理，跳过这步直接用
cv::imread()更安全（它内部已处理格式识别、色彩空间转换、内存对齐） - 用
std::ifstream手动读取再传给cv::imdecode()是可行折中方案，但需确保完整读入且不截断（检查gcount()）
cv::imread() 读取失败的三个常见原因
返回空 cv::Mat 是最常遇到的问题，不是代码写错，而是路径、编码、权限或格式支持出了问题。
- 路径含中文或空格时，Windows 下
cv::imread("D: est猫.jpg")会因反斜杠转义失败；应改用正斜杠或双反斜杠："D:/test/猫.jpg"或"D:\test\猫.jpg" - OpenCV 默认不支持 WebP、HEIC 等格式，即使文件存在也会静默失败；可先用
cv::haveImageReader(".webp")检查支持性 - Linux/macOS 下注意当前工作目录：
cv::imread("img.png")查找的是进程启动路径下的img.png，不是源码同目录；建议用绝对路径或构建时显式指定资源路径
不用 OpenCV 时，用 stb_image.h 轻量解码 JPEG/PNG
如果项目不能链接 OpenCV（比如嵌入式、小游戏引擎），stb_image 是最实用的选择：单头文件、零依赖、支持常见格式，且解码后数据排布与 OpenCV 兼容（BGR/RGB 可选）。
- 使用前必须定义
STB_IMAGE_IMPLEMENTATION且只在一个 .cpp 文件中定义一次，否则重复符号错误 - 解码后返回的是裸指针
uint8_t*，需手动stbi_image_free()释放，忘记会导致内存泄漏 - 默认按 RGB 顺序解码 PNG，但 OpenCV 的
cv::Mat默认是 BGR；若要直接赋值，用stbi_set_flip_vertically_on_load(1)控制 Y 轴翻转，或传STBI_rgb并自己重排通道
int w, h, channels;
uint8_t* pixels = stbi_load("photo.png", &w, &h, &channels, STBI_rgb);
if (!pixels) {
// 打印 stbi_failure_reason() 查具体错误
}
cv::Mat img(h, w, CV_8UC3, pixels); // 注意：此时是 RGB，不是 OpenCV 默认 BGR
stbi_image_free(pixels);
读取后立即检查图像有效性比“假设成功”更可靠
很多崩溃发生在对空 cv::Mat 调用 .data 或进行 cv::cvtColor()，而不是读取环节本身。防御性检查应在解码后立刻执行。
立即学习“C++免费学习笔记（深入）”；
- 检查
mat.empty()是必须的，但还不够；还需确认mat.isContinuous()（尤其从 ROI 或子矩阵得来时） - 对灰度图做彩色操作前，用
mat.channels() == 3显式判断，避免cv::cvtColor(mat, mat, cv::COLOR_GRAY2BGR)对非灰度图误操作 - 调试时加一句
std::cout ，能快速暴露位深（<code>CV_8UC1vsCV_16UC1）和通道数问题
实际图像处理中，读取只是起点，真正容易出问题的是后续对 cv::Mat 内存生命周期、通道顺序、ROI 引用关系的理解——这些细节不会报编译错误，但会在运行时随机崩掉或输出全黑图像。
