窗口一闪就消失是因为cv::imshow()仅提交图像数据且不阻塞，程序立即退出导致窗口关闭；必须调用cv::waitkey(0)无限等待按键或cv::waitkey(1)用于视频循环，并需先检查cv::imread()返回的mat是否为空。
cv::imshow() 为什么窗口一闪就消失？
因为 cv::imshow() 只负责渲染，不阻塞主线程；调用后程序立刻执行完退出，窗口随之关闭。必须加 cv::waitKey() 等待用户输入，否则看不到图像。
-
cv::waitKey(0)：无限等待，直到按键才继续（适合单图查看） -
cv::waitKey(1)：至少等待 1ms，常用于视频循环（注意：在某些系统上低于 1ms 可能不生效） - 不要写成
waitKey(-1)—— 虽然部分 OpenCV 版本兼容，但语义不清，官方文档只定义了非负整数和 0 - 如果图像路径错误导致
cv::imread()返回空cv::Mat，imshow()不报错但显示灰色窗口，需提前检查mat.empty()
cv::imread() 加载失败的常见原因
OpenCV 默认不报路径错误，cv::imread() 静默返回空 cv::Mat，容易误以为是显示问题。
- 相对路径基于**当前工作目录**，不是 .cpp 文件所在目录 —— 命令行运行时 pwd 是关键
- 中文路径在 Windows 上大概率失败，建议用英文路径或改用
cv::imread(cv::String("路径"), cv::IMREAD_COLOR)+ UTF-8 编码（需 C++17+ 和编译器支持） - 文件扩展名大小写敏感（Linux/macOS），
"image.JPG"≠"image.jpg" - OpenCV 默认不支持 WebP、JPEG2000 等格式，除非编译时启用了对应后端（如 libjpeg-turbo、libwebp）
cv::namedWindow() 有必要显式调用吗？
大多数情况不需要。直接用 cv::imshow("win", mat) 会自动创建同名窗口；但若需控制窗口属性（如可缩放、无边框），就必须先调用 cv::namedWindow()。
-
cv::namedWindow("win", cv::WINDOW_AUTOSIZE)：窗口大小固定为图像尺寸 -
cv::namedWindow("win", cv::WINDOW_NORMAL)：允许拖拽缩放（调试大图必备） - 重复调用
namedWindow()同名窗口不会出错，但也不会重置状态（比如已缩放的窗口不会恢复） - Windows 下若程序异常退出，窗口可能残留且无法响应 —— 这是 GUI 线程未清理所致，非代码 bug
多图显示时窗口重叠或标题被截断怎么办？
OpenCV 的窗口管理很基础，不自动避让。同名窗口会复用，不同名则依次右下偏移，但偏移量固定，易重叠。
- 给每个
imshow()传不同字符串，如"src"、"gray"、"edges" - 用
cv::moveWindow("win", x, y)手动定位（x/y 单位是像素，原点在左上角） - 标题过长时，Windows 系统会省略中间字符，macOS/Linux 通常只显示前几十个字 —— 建议标题控制在 20 字以内
- Linux 下若使用 Wayland，
imshow()可能完全黑屏或崩溃，需切回 X11 或改用 Qt 后端（编译时启用WITH_QT=ON）
waitKey()。C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
