Mac下VSCode用C++ OpenCV读图片出现libpng版本不匹配及imshow报错如何解决

你遇到的报错分为两个关联问题：

1. libpng版本冲突：你本地安装的OpenCV是基于libpng-1.4.12编译的，但你在CMake配置中强制链接了libpng-1.6.37，运行时动态库符号冲突，导致PNG格式图片读取失败
2. imshow断言报错：因为libpng冲突导致图片读取为空，imshow要求输入的图片宽高都大于0，空矩阵触发了断言校验直接崩溃

• 第一步：先排除图片路径错误
  在imread读取图片后新增空值校验，先确认不是相对路径填写错误导致的图片读取失败：

  cv::Mat img = cv::imread("你的图片路径");
  if (img.empty()) {
      std::cout << "图片读取失败，请检查路径是否正确" << std::endl;
      return -1;
  }
  

  注意Mac下VSCode运行C++程序时，相对路径默认是相对于执行文件所在的build目录，不是源码目录，建议优先使用绝对路径测试。

• 第二步：解决libpng版本冲突
  优先尝试最简单的调整方案：修改CMakeLists.txt中的链接顺序，将libpng放在OpenCV前面，优先加载高版本libpng的符号，避免冲突：
  把原来的

  target_link_libraries(${PROJECT_NAME} ${OpenCV_LIBS} ${LIBPNG_LIBRARIES})
  

  改成

  target_link_libraries(${PROJECT_NAME} ${LIBPNG_LIBRARIES} ${OpenCV_LIBS})
  

  如果调整顺序无效，再尝试以下方案：

  1. 如果你是通过Homebrew安装的OpenCV，直接执行brew upgrade opencv，Homebrew会自动匹配依赖的libpng版本，编译匹配的OpenCV版本
  2. 手动重新编译OpenCV，编译时指定WITH_PNG=ON，并且将PNG依赖路径指向你系统中的libpng1.6路径，保证OpenCV和你的项目使用同一版本的libpng

• 第三步：清理缓存重新构建
  每次修改完CMake配置后，必须清空项目build目录下的所有缓存文件，再重新执行cmake .. && make构建，避免旧缓存导致配置不生效。

内容的提问来源于stack exchange，提问作者Aniekan jr