cv::imread读取失败最常见原因是路径或编码问题：Windows下中文路径不支持、相对路径未对准当前工作目录、反斜杠未转义，均导致返回空Mat；应先检查img.empty()，优先用绝对路径测试，并确保OpenCV库Debug/Release版本匹配。
cv::imread 读取失败的常见原因
直接用 cv::imread 读不到图，八成不是代码写错，而是路径或编码问题。Windows 下中文路径、相对路径没对准当前工作目录、路径里用了反斜杠 \ 却没转义，都会让返回空 cv::Mat。先检查 mat.empty()，别急着画窗。
- 用绝对路径测试（如
"C:/test/lena.jpg"），确认函数本身能工作 - VS 调试时当前工作目录默认是项目根目录，不是源文件所在目录；右键项目 → 属性 → 配置属性 → 调试 → 工作目录，可改成
$(ProjectDir) - 路径含中文？OpenCV 4.8+ 的
cv::imread仍不支持 UTF-8 字符串传参，得用cv::imread(cv::utils::fs::glob(...))或 Windows API 先读为字节流再用cv::imdecode
cv::imshow 显示黑窗或崩溃
显示黑窗通常因为图像数据为空或类型不支持；崩溃多因窗口名重复、未调用 cv::waitKey，或在多线程中跨线程调用 GUI 函数。
- 务必在
cv::imshow后加cv::waitKey(0)，否则窗口刷新被阻塞，图像不渲染 - 窗口名必须是唯一字符串，重复调用
cv::imshow("win", img)不会报错但可能覆盖或异常，建议每次用不同名或提前cv::destroyWindow("win") - 如果图是单通道（如灰度图）但用
CV_32F类型，imshow会按 [0,1] 归一化显示——全黑或全白，需先convertScaleAbs或手动缩放到 [0,255]
完整可跑的最小示例（含错误防护）
#include <opencv2/opencv.hpp>
#include <iostream>
int main() {
cv::Mat img = cv::imread("lena.jpg"); // 确保该文件在当前工作目录
if (img.empty()) {
std::cerr << "Failed to load image\n";
return -1;
}
std::cout << "Loaded: " << img.size() << ", type=" << img.type() << "\n";
cv::imshow("Image", img);
cv::waitKey(0); // 按任意键退出
return 0;
}
编译时链接 OpenCV 库（如 -lopencv_core -lopencv_imgproc -lopencv_highgui），Windows 下注意 DLL 路径是否在 PATH 中——缺 DLL 也会静默失败，只显示黑窗。
读取后立刻显示但图偏色？
OpenCV 默认用 BGR 顺序读图，而多数显示工具（如 matplotlib、浏览器）按 RGB 解释。如果你后续要存图或对接其他库，这个顺序差容易被忽略。
立即学习“C++免费学习笔记（深入）”；
- 显示本身不受影响（
cv::imshow就是按 BGR 渲染的），但若你用 Qt / SDL 等自己渲染，就得先cv::cvtColor(img, img, cv::COLOR_BGR2RGB) - 保存图用
cv::imwrite仍是 BGR，结果正确；但若用cv::imencode转成 JPEG 字节数组再发给 Web 前端，前端 expect RGB，就真会偏色 - 调试时快速看通道：用
cv::split拆成三个单通道 Mat，分别imshow，B 通道对应蓝，G 对应绿，R 对应红——顺序错一眼就能看出
路径、空图、BGR 顺序、waitKey 缺失——这四点卡住的人最多，其他都是衍生问题。
