cv::imread读取失败首要检查返回值if(img.empty())，常见原因包括路径含中文/空格、相对路径基准错误、opencv库debug/release版本混用、图片格式不支持或损坏。
cv::imread 读不到图？路径和返回值检查是第一关
绝大多数“图片没显示”问题其实卡在 cv::imread 就失败了，它不报错，只默默返回空 cv::Mat。必须立刻检查返回值：if (img.empty())，而不是直接传给 cv::imshow。
常见原因：
- 路径含中文或空格——Windows 下尤其容易出问题，改用绝对路径并用正斜杠（
"C:/data/test.jpg"）或双反斜杠（"C:\data\test.jpg"） - 相对路径基于**可执行文件所在目录**，不是 .cpp 文件位置；用 CMake 构建时注意输出目录（如
build/），把图片放进去再试 - OpenCV 不支持某些编码格式的 PNG（比如带深层 Alpha 预乘），换用 JPEG 或用
cv::IMREAD_UNCHANGED显式指定读取方式 - Linux/macOS 区分大小写，
"Test.JPG"≠"test.jpg"
cv::imshow 窗口一闪而逝？别忘了 cv::waitKey
cv::imshow 只负责把图像数据推到窗口缓冲区，不阻塞主线程。如果后面没跟 cv::waitKey，窗口创建后立即退出，人眼根本来不及看到。
关键点：
-
cv::waitKey(0)表示无限等待按键（推荐调试时用） -
cv::waitKey(1)常用于视频循环，但对单张图也有效——它至少等待 1ms，足够触发窗口刷新 - 必须在
cv::imshow**之后调用**，且不能放在return前面就结束程序 - 如果用了
cv::namedWindow("win", cv::WINDOW_AUTOSIZE)，确保cv::imshow的窗口名完全一致（区分大小写）
图像显示发灰、偏色？检查 Mat 类型和通道顺序
OpenCV 默认用 BGR 顺序读图，而多数显示器/画图软件按 RGB 渲染。如果你用 cv::imread("xxx.jpg") 读 JPEG，得到的是 CV_8UC3 类型的 BGR 图；直接丢给其他库（如 Qt、SDL）或误以为是 RGB，颜色就会错乱。
典型表现：
- 人脸泛青（蓝红通道颠倒）
- 灰度图显示成全黑或全白（实际是
CV_8UC1，但被当CV_8UC3解释） - 透明 PNG 显示为黑底（Alpha 通道未处理，
cv::imshow忽略 Alpha）
验证方法：打印 img.type() 和 img.channels()；需要 RGB 就加一句 cv::cvtColor(img, img_rgb, cv::COLOR_BGR2RGB)。
Linux 下 imshow 报错 “Gtk: cannot open display”？你缺 GUI 环境
这个错误不是 OpenCV 的锅，而是你的程序运行在无图形界面的环境（比如 SSH 连上去没开 X11 转发，或 Docker 容器没挂载 DISPLAY）。cv::imshow 底层依赖 GTK / Qt / Cocoa，没显示服务就崩。
能做的选择：
- 本地开发：SSH 登录时加
-X参数（ssh -X user@host），并确认本机装了 X Server（macOS 用 XQuartz，Windows 用 VcXsrv/Xming） - 服务器部署：改用
cv::imwrite保存结果图，再通过 HTTP 或 SCP 拿出来看 - Docker：启动容器时加
--env="DISPLAY" --volume="/tmp/.X11-unix:/tmp/.X11-unix:rw"，且宿主机需允许 xhost 接入
没有 GUI 时硬调 cv::imshow 不会崩溃，但会静默失败或报错退出——这点比 Windows 更不宽容。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
