CMake已定位OpenCV目录，C++项目运行时仍提示头文件缺失

问题背景 #

项目文件结构：

IllusionEngine/
│
├─ build/
│
├─ src/
│   ├── images/
│   │    └── chair1.png
│   └── main.cpp
│
└── CMakeLists.txt

CMake配置文件内容：

cmake_minimum_required(VERSION 3.29.3)
project(IllusionEngine VERSION 0.1.0)

include(CTest)
enable_testing()

find_package(OpenCV REQUIRED)
include_directories(${OpenCV_INCLUDE_DIRS})

add_executable(IllusionEngine src/main.cpp)

target_link_libraries(IllusionEngine ${OpenCV_LIBS})

set(CPACK_PROJECT_NAME ${PROJECT_NAME})
set(CPACK_PROJECT_VERSION ${PROJECT_VERSION})
include(CPack)

CMake执行输出显示已成功找到OpenCV：

[cmake] -- Found OpenCV: C:/opencv/build (found version "4.9.0")
[cmake] -- Configuring done (2.3s)
[cmake] -- Generating done (0.1s)
[cmake] -- Build files have been written to: C:/Users/arhub/OneDrive/Documents/WIP-AydenHubenak/IllusionEngine/build

但编译时出现头文件找不到的错误：

c:\Users\arhub\OneDrive\Documents\WIP-AydenHubenak\IllusionEngine\src\main.cpp:1:10: fatal error: opencv2/opencv.hpp: No such file or directory
    1 | #include <opencv2/opencv.hpp>
      |          ^~~~~~~~~~~~~~~~~~~~
compilation terminated.

解决方案 #

修改CMakeLists.txt，使用现代CMake的目标关联方式替代全局头文件设置，确保头文件路径正确传递到编译目标：

cmake_minimum_required(VERSION 3.29.3)
project(IllusionEngine VERSION 0.1.0)

include(CTest)
enable_testing()

find_package(OpenCV REQUIRED)

add_executable(IllusionEngine src/main.cpp)

# 替换全局include_directories，仅将OpenCV头文件路径关联到目标
target_include_directories(IllusionEngine PRIVATE ${OpenCV_INCLUDE_DIRS})
target_link_libraries(IllusionEngine PRIVATE ${OpenCV_LIBS})

set(CPACK_PROJECT_NAME ${PROJECT_NAME})
set(CPACK_PROJECT_VERSION ${PROJECT_VERSION})
include(CPack)

修改说明 #

• include_directories是全局设置，在部分构建环境中可能无法正确传递到指定编译目标；target_include_directories则明确将头文件路径绑定到IllusionEngine可执行目标，可靠性更高。
• PRIVATE关键字表示这些头文件仅用于当前目标的编译，符合现代CMake的最佳实践。

额外排查步骤 #

1. 验证OpenCV安装完整性：检查C:/opencv/build/include/opencv2/opencv.hpp是否存在，若不存在则说明OpenCV安装不完整，需重新下载安装对应版本。
2. 清理缓存重新构建：删除build目录下的所有文件，重新运行CMake配置和构建命令，避免旧缓存导致的配置异常。
3. 检查IDE配置：若使用VS等IDE开发，确保选中CMake生成的正确构建目标，且IDE已重新加载最新的CMake配置。

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