Windows编译OpenCV 4.10时头文件路径错误问题求助

问题背景 #

在Windows环境下从源码升级OpenCV到4.10版本，需构建两个独立版本：

• 基于GCC（MSYS2）的版本，已编译成功
• 基于MSVC的版本，使用NMake生成器与cl原生编译器，编译modules/imgcodecs/CMakeFiles/opencv_imgcodecs.dir/src/loadsave.cpp.obj时失败

具体异常：编译该文件时，引入vcruntime.h后，系统从MSYS2的...\msys64\ucrt64\include\sal.h加载头文件，而非MSVC自带的C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.40.33807\include\路径下的对应文件，最终导致uintptr_t等符号未定义。其他OpenCV文件编译时可正常从MSVC路径加载头文件，仅loadsave.cpp出现此问题。当前环境变量PATH中MSVC工具路径优先级高于MSYS2，INCLUDE仅包含MSVC相关路径。

可行解决办法 #

1. 强制指定MSVC头文件路径优先级 #

在CMake配置阶段，通过编译参数手动将MSVC头文件目录放在搜索顺序最前，确保编译器优先查找：

set(CMAKE_CXX_FLAGS "/I\"C:/Program Files (x86)/Microsoft Visual Studio/2022/BuildTools/VC/Tools/MSVC/14.40.33807/include\" /I\"C:/Program Files (x86)/Windows Kits/10/Include/10.0.22621.0/ucrt\" ${CMAKE_CXX_FLAGS}")

注意替换Windows Kits的版本号为你实际安装的版本，可在C:\Program Files (x86)\Windows Kits\10\Include目录下查看。

2. 单独调整模块的头文件搜索顺序 #

针对opencv_imgcodecs模块修改CMake配置，在构建目录下的modules/imgcodecs/CMakeLists.txt中，添加前置头文件目录：

include_directories(BEFORE "C:/Program Files (x86)/Microsoft Visual Studio/2022/BuildTools/VC/Tools/MSVC/14.40.33807/include")
include_directories(BEFORE "C:/Program Files (x86)/Windows Kits/10/Include/10.0.22621.0/ucrt")

修改后重新运行CMake生成构建文件，再执行编译。

3. 使用MSVC专属命令行环境 #

避免在MSYS2终端中编译MSVC版本，改用Visual Studio自带的Developer Command Prompt for VS 2022或x64 Native Tools Command Prompt for VS 2022启动终端，在纯净的MSVC环境下完成构建：

# 进入OpenCV源码目录
cd D:/opencv-4.10.0
# 创建MSVC专属构建目录
mkdir build-msvc && cd build-msvc
# 配置CMake（指定NMake生成器）
cmake -G "NMake Makefiles" -DCMAKE_INSTALL_PREFIX=D:/opencv-msvc-install -DCMAKE_BUILD_TYPE=Release ..
# 编译并安装
nmake
nmake install

该环境会自动配置MSVC专属环境变量，完全隔离MSYS2的路径干扰。

4. 禁用系统头文件自动导入 #

在CMake配置时，添加选项阻止从导入目标中自动添加系统头文件路径，避免MSYS2依赖库引入额外路径：

set(CMAKE_NO_SYSTEM_FROM_IMPORTED ON)

同时强制指定标准头文件路径：

set(CMAKE_CXX_STANDARD_INCLUDE_DIRECTORIES "C:/Program Files (x86)/Microsoft Visual Studio/2022/BuildTools/VC/Tools/MSVC/14.40.33807/include" "C:/Program Files (x86)/Windows Kits/10/Include/10.0.22621.0/ucrt")

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