Windows 8.1下Qt Creator配置OpenCV3.4出现头文件未找到问题
OpenCV3.4 配置下头文件找不到的解决步骤
你遇到的opencv2/core/core.hpp file not found报错,核心诱因是.pro配置文件的qmake语法不符合规则,叠加部分环境细节疏漏,按以下顺序排查即可快速解决:
1. 修正.pro文件的语法错误(最核心原因)
qmake的多行路径续行规则和通用Makefile有区别:只有行尾加反斜杠\,才能将下一行内容纳入当前指令的作用域。你当前的写法是单独用正斜杠/占一行做分隔,等于只把Eigen的路径加进了INCLUDEPATH,OpenCV的头文件路径因为脱离了指令作用域,被qmake直接忽略,自然会报找不到头文件。
另外Windows路径在qmake中建议统一用正斜杠/书写,避免单反斜杠被解析为转义符导致路径失效。
匹配你给出的实际路径,修正后的正确配置为:
# 头文件搜索路径 INCLUDEPATH += G:/Qt/libs/Eigen3/eigen-3.4-rc1 \ G:/Qt/libs/opencv/build_opencv/install/include # 动态库链接路径 LIBS += G:/Qt/libs/opencv/build_opencv/install/x64/mingw/bin/libopencv_*.dll
2. 验证头文件路径的实际层级
手动打开你配置的OpenCV include路径,逐层检查文件结构:
- 路径下应当直接存在
opencv2文件夹 - 进入
opencv2目录,能找到core.hpp文件
如果实际目录层级有偏差(比如安装后头文件在include/opencv2/opencv2/下),需要在INCLUDEPATH里补充对应层级,直到匹配到能直接搜索到opencv2文件夹的根路径。
3. 清除旧构建缓存后重新执行qmake
qmake会缓存之前生成的Makefile配置,改完.pro文件后不能直接点击构建,必须按顺序操作:
- 右键项目菜单选择「执行qmake」
- 依次选择「构建」→「清理项目」→「清除所有缓存」
- 重新执行项目构建
如果不清除旧缓存,哪怕.pro内容写对了,构建时还是会调用之前不带OpenCV路径的旧Makefile,一样会触发头文件找不到的报错。
4. 提前规避后续配置坑
结合你当前的环境版本(Qt 5.15.2 MinGW64、CMake3.19.2、Win8.1),提前核对两项配置避免出现新报错:
- 确认编译OpenCV时使用的MinGW版本,和Qt自带的MinGW 64-bit版本完全一致(通常为MinGW 8.1.0 64位版本),不要用独立安装的MinGW版本编译OpenCV,否则后续会出现链接阶段的符号不匹配错误
- 系统PATH环境变量里添加的MinGW路径,优先指向Qt安装目录下的MinGW bin目录(比如
G:/Qt/Tools/mingw810_64/bin),避免被其他软件携带的MinGW路径抢占优先级,导致qmake调用错误的编译器
内容的提问来源于stack exchange,提问作者Mentholatum
相关产品推荐
相关产品推荐

