如何在MSYS2中安装OpenCV扩展及非免费模块？

一、MSYS2环境编译带全模块的OpenCV（解决OpenImageIO冲突） #

MSYS2默认的OpenCV包不含扩展模块（opencv_contrib）和非免费模块，且和OpenImageIO的依赖链绑定，必须编译与OpenImageIO依赖版本完全匹配的OpenCV才能解决冲突：

1. 更新MSYS2环境
   打开UCRT64终端（推荐用UCRT64，兼容性最优），执行：

   pacman -Syu
   

   重启终端后再执行一次，确保所有包更新完成。

2. 安装编译依赖
   安装编译工具链、OpenImageIO及其他必要依赖：

   pacman -S base-devel git cmake mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-openimageio mingw-w64-ucrt-x86_64-python3 mingw-w64-ucrt-x86_64-ninja
   

3. 匹配版本克隆源码
   先查看OpenImageIO依赖的OpenCV版本：

   pacman -Qi mingw-w64-ucrt-x86_64-openimageio | grep Depends
   

   比如输出显示依赖mingw-w64-ucrt-x86_64-opencv=4.5.5，就克隆对应tag的源码：

   git clone --branch 4.5.5 https://github.com/opencv/opencv.git
   git clone --branch 4.5.5 https://github.com/opencv/opencv_contrib.git
   

4. CMake配置编译参数
   创建构建目录并配置，核心是指定安装路径覆盖MSYS2默认包，开启扩展和非免费模块：

   mkdir opencv-build && cd opencv-build
   cmake -G Ninja \
     -DCMAKE_INSTALL_PREFIX=/ucrt64 \
     -DOPENCV_EXTRA_MODULES_PATH=../opencv_contrib/modules \
     -DOPENCV_ENABLE_NONFREE=ON \
     -DBUILD_opencv_world=ON \
     -DCMAKE_BUILD_TYPE=Release \
     ../opencv
   

   • CMAKE_INSTALL_PREFIX=/ucrt64：将编译后的OpenCV安装到MSYS2系统目录，直接替换默认包，确保OpenImageIO调用这个全模块版本
   • OPENCV_ENABLE_NONFREE：启用SIFT等非免费算法模块
   • BUILD_opencv_world：打包所有模块为单个库，减少链接冲突

5. 编译安装并清理默认包

   ninja
   ninja install
   # 卸载默认OpenCV包避免残留
   pacman -Rns mingw-w64-ucrt-x86_64-opencv
   

二、双编译器（MSVC/GCC）项目配置 #

用CMake实现跨编译器兼容，无需修改项目代码：

• MSVC编译：单独安装Windows版带扩展模块的OpenCV（可从官网下载预编译包或自行编译），设置系统环境变量OpenCV_DIR指向MSVC版OpenCV的cmake目录，然后用VS的CMake工具链编译即可。
• MSYS2 GCC编译：直接在UCRT64终端中运行CMake，会自动调用MSYS2的GCC和刚才编译的OpenCV：

  mkdir build && cd build
  cmake -G Ninja ..
  ninja
  

三、版本冲突预防措施 #

• 每次更新MSYS2包前，先检查OpenImageIO的依赖版本，确保编译的OpenCV版本完全匹配
• 用pacman -Q | grep opencv检查MSYS2中仅存在一个OpenCV版本
• 若需临时切换版本，可通过修改CMAKE_PREFIX_PATH环境变量指定对应OpenCV的安装路径

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