OpenCV imread读取失败主因是路径和编码问题：路径含中文/空格、相对路径错误、格式不支持（如WebP）；Windows需用"/"或"\\"，避免"\"转义；建议用绝对路径测试并打印当前工作目录。
OpenCV imread 读不到图？先确认路径和编码问题
绝大多数“读取失败”不是代码写错，而是 imread 返回空 cv::Mat。常见原因有三个：路径含中文或空格、相对路径没对上工作目录、图片格式不被支持（比如 WebP 或某些带 alpha 的 PNG）。Windows 下尤其要注意路径分隔符——用正斜杠 "/" 或双反斜杠 "\\\\"，别用单反斜杠 "\"（会被当转义符）。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用绝对路径测试，例如
cv::imread("C:/test/image.jpg")，排除路径解析问题 - 打印当前工作目录：
std::cout （Windows）或getcwd（Linux/macOS），确认相对路径基准点 - 检查返回值：
if (img.empty()) { std::cerr ，别跳过这步 - OpenCV 默认不支持 JPEG2000、WebP 等格式，如需支持，编译时得开
WITH_JASPER或WITH_WEBP，预编译包通常不带
Visual Studio 配置 OpenCV 的关键三步（x64 + Debug）
配环境卡住，90% 出在“平台/配置不匹配”。VS 项目默认是 x86，但多数 OpenCV 预编译库是 x64；Debug 模式下必须连 opencv_world4xxd.lib（带 d 后缀），连错 release 库会报 LNK2019。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 项目属性 → “常规” → “平台工具集” 和 “Windows SDK 版本” 要与 OpenCV 编译时一致（比如 v143 + 10.0.22621.0）
- “C/C++” → “附加包含目录” 加入
opencv/build/include - “链接器” → “附加库目录” 加入
opencv/build/x64/vc17/lib（vc17 对应 VS2022） - “链接器” → “输入” → “附加依赖项” 填
opencv_world410d.lib（版本号按你实际用的改，Debug 用d，Release 去掉d） - 运行前把
opencv/build/x64/vc17/bin下的 DLL（如opencv_world410d.dll）复制到可执行文件同目录，否则报“找不到 dll”
imshow 显示窗口一闪而逝？cv::waitKey 是关键
cv::imshow 只负责开窗绘图，不阻塞主线程。窗口闪退是因为 main 函数结束、进程退出。必须调用 cv::waitKey 才能维持窗口并捕获键盘事件。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 显示后加
cv::waitKey(0)：等待任意键按下才继续（适合调试） - 做视频处理时用
cv::waitKey(30)：约 33 FPS，数值太小窗口可能没刷新完就关了 - 注意：
waitKey必须在imshow之后调用，且同一线程内不能漏掉——哪怕只显示一张图 - Linux 下若报
cv::imshow: can't connect to X server，说明没图形界面（如 SSH 登录未开 X11 转发），此时只能保存结果用cv::imwrite
读取后图像通道顺序是 BGR，不是 RGB
OpenCV 默认用 BGR 顺序存储像素，和绝大多数图像查看器、网页、matplotlib 的 RGB 不一致。直接拿 cv::Mat 数据喂给 OpenGL、Qt 或保存为 PNG 再用浏览器打开，颜色会发紫（蓝红颠倒）。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 转 RGB 用
cv::cvtColor(img, img_rgb, cv::COLOR_BGR2RGB) - 保存前无需转换：
cv::imwrite自动按格式写，BGR 存 JPG 也没问题 - 如果后续要用
cv::dnn模块（如 YOLO），很多模型要求归一化+RGB+CHW 排列，得连着做cvtColor、convertScaleAbs、blobFromImage - 用
img.type()查类型：16 表示 CV_8UC3（3 通道 8 位），0 表示 CV_8UC1（灰度），别靠肉眼猜
opencv_world410d.lib 写成 opencv_world410.lib）就会静默失败——它不会报错，只是 imread 返回空 Mat。 
