CMake头文件无法找到（致命错误：文件未找到）——MacOS下VS Code+Clang环境CMake项目配置求助

我来帮你排查下这个头文件找不到的问题，看了你的CMake配置和项目结构，核心问题出在app模块的CMake配置错误，导致编译时无法正确识别engine模块的头文件路径。下面是具体的修复步骤和解释：

1. 修正app目录下的CMakeLists.txt #

你当前在app的CMake中写的target_include_directories(${PROJECT_NAME} PRIVATE vulkanEngine_engine)是错误的——vulkanEngine_engine是目标库的名称，不是头文件路径。实际上，只要正确链接engine库，CMake会自动继承engine暴露的PUBLIC头文件路径，不需要手动指定。

修改后的app/CMakeLists.txt应该是这样：

cmake_minimum_required(VERSION 3.5)
project(vulkanEngine VERSION 0.0.1 LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 20)

add_executable(${PROJECT_NAME} src/main.cpp)
# 链接engine库，这里用PRIVATE表示app依赖engine，但不需要把engine的依赖暴露给其他目标
target_link_libraries(${PROJECT_NAME} PRIVATE vulkanEngine_engine)

2. 确认engine目录的CMake配置（无需修改，但要理解作用） #

你的engine/CMakeLists.txt配置是正确的：

target_include_directories(${PROJECT_NAME} 
    PUBLIC 
        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include> 
        $<INSTALL_INTERFACE:include> 
    PRIVATE 
)

这里的PUBLIC关键字会把${CMAKE_CURRENT_SOURCE_DIR}/include目录标记为接口包含目录，所有链接这个库的目标（比如app）都会自动获得这个路径，所以你在cpp中用#include <project_engine/engine.h>是完全正确的写法。

3. 清理缓存并重新编译 #

之前的错误配置可能已经生成了缓存文件，导致修改后不生效，所以先清理build目录再重新构建：

# 回到项目根目录
cd ..
rm -rf build
mkdir build && cd build
cmake ..
make

4. 解决VS Code IntelliSense的提示问题（可选） #

如果VS Code的代码编辑器仍然显示头文件找不到的红色波浪线，这是IntelliSense的配置问题，和实际编译无关。可以在项目根目录创建.vscode/c_cpp_properties.json文件，添加engine的include路径：

{
    "configurations": [
        {
            "name": "MacOS",
            "includePath": [
                "${workspaceFolder}/**",
                "${workspaceFolder}/engine/include"
            ],
            "defines": [],
            "compilerPath": "/usr/bin/clang",
            "cStandard": "c17",
            "cppStandard": "c++20",
            "intelliSenseMode": "macos-clang-x64"
        }
    ],
    "version": 4
}

为什么之前的尝试没生效？ #

• 你用include_directories是全局配置，优先级低于目标级的target_include_directories，而且会污染整个项目的路径，不如后者可靠；
• VS Code的包含路径设置只是影响编辑器的代码提示，实际编译的路径完全由CMake决定，所以CMake配置错误才是根本原因；
• 两种#include写法（尖括号和双引号）在正确配置路径后都能生效，问题不在这里。

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