CMake已添加INTERFACE库包含目录，但VS2022中无法访问

我正使用CMake v3.30.5创建基于VS2022的C++项目，希望通过FetchContent引入第三方代码而不加入源码树。第三方代码将放在项目根目录的SDKs文件夹，供根目录下的Core项目使用。首先引入FastDelegate（仅头文件库），将其声明为INTERFACE库（无编译源文件）。

现有CMake配置 #

根目录CMakeLists.txt #

cmake_minimum_required(VERSION 3.24)

project(MyProj
    LANGUAGES CXX
    VERSION 0.0.1)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED True)
list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/CMake")
set(SDK_DIR "${CMAKE_CURRENT_SOURCE_DIR}/SDKs")
set_property(GLOBAL PROPERTY USE_FOLDERS ON)

add_subdirectory(SDKs)
add_subdirectory(Core)

SDKs目录CMakeLists.txt #

include (FetchContent)

FetchContent_Declare(FastDelegate
        GIT_REPOSITORY https://github.com/dreamcat4/FastDelegate.git
        GIT_PROGRESS true
        SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/FastDelegate"
        BINARY_DIR "${CMAKE_BINARY_DIR}/SDKs/FastDelegate"
        FIND_PACKAGE_ARGS)

FetchContent_MakeAvailable(FastDelegate)

FindFastDelegate.cmake（位于CMake目录） #

cmake_minimum_required(VERSION 3.24)

set(SRC_DIR "${SDK_DIR}/FastDelegate")

add_library(FastDelegate INTERFACE
    "${SRC_DIR}/FastDelegate.h"
    "${SRC_DIR}/FastDelegateBind.h")
add_library(SDK::FastDelegate ALIAS FastDelegate)
target_include_directories(FastDelegate INTERFACE ${SRC_DIR})
set_target_properties(FastDelegate PROPERTIES FOLDER "SDKs/FastDelegate")

Core目录CMakeLists.txt #

cmake_minimum_required(VERSION 3.24)

add_library(Core STATIC
    Core_defines.h) 
set_target_properties(Core PROPERTIES LINKER_LANGUAGE CXX)
target_include_directories(Core PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})

target_link_libraries(Core
    PUBLIC
        SDK::FastDelegate)

# added this to make sure include directories are correct
file(GENERATE OUTPUT "$<CONFIG>output.txt"
    CONTENT "$<TARGET_PROPERTY:Core,INCLUDE_DIRECTORIES>")

异常情况 #

测试输出显示Core库的包含目录为C:/Projects/MyProj/Core;C:/Projects/MyProj/SDKs/FastDelegate，符合预期。但MSVC项目中未列出这些目录，且无法#include FastDelegate文件。

请问我是否遗漏了步骤、操作有误，还是CMake存在问题？

问题根源 #

你的配置存在两个关键问题：

1. 变量传递失效：SDK_DIR是在根CMakeLists.txt中定义的普通变量，find_package执行Find模块时，该变量不会自动传递到模块作用域，导致FindFastDelegate.cmake中SRC_DIR路径错误。
2. INTERFACE库头文件声明冗余：仅头文件的INTERFACE库不需要将头文件加入add_library的源列表，反而可能干扰IDE对包含目录的识别。

修正步骤 #

1. 修复Find模块的路径定位

在FindFastDelegate.cmake中，通过CMAKE_CURRENT_LIST_DIR直接回溯到项目根目录，避免依赖外部变量：

cmake_minimum_required(VERSION 3.24)

# 直接通过模块位置定位SDK路径，无需依赖外部变量
set(SRC_DIR "${CMAKE_CURRENT_LIST_DIR}/../SDKs/FastDelegate")

add_library(FastDelegate INTERFACE)
add_library(SDK::FastDelegate ALIAS FastDelegate)
target_include_directories(FastDelegate INTERFACE ${SRC_DIR})
set_target_properties(FastDelegate PROPERTIES FOLDER "SDKs/FastDelegate")

# 可选：如果希望头文件出现在VS项目结构中，添加以下代码
target_sources(FastDelegate INTERFACE
    "${SRC_DIR}/FastDelegate.h"
    "${SRC_DIR}/FastDelegateBind.h")

2. 重置构建环境

删除原有构建目录，重新生成VS项目，避免缓存干扰：

rm -rf build
cmake -S . -B build -G "Visual Studio 17 2022"

3. IDE缓存清理

如果VS仍未识别包含目录，手动重置IntelliSense缓存：

• 打开VS→工具→选项→文本编辑器→C/C++→高级→点击「重置IntelliSense缓存」

额外验证点 #

• 确认FetchContent已成功将FastDelegate源码下载到SDKs/FastDelegate目录
• 在VS中右键Core项目→属性→C/C++→常规→附加包含目录，检查是否存在SDKs/FastDelegate路径

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