Visual Studio下CMake配置SFML头文件引用的语法疑问

我用Visual Studio的CMake模板开发C++项目，想运行SFML示例代码，不想复制SFML头文件到项目里，直接引用外部库目录。

项目结构 #

Program3
├── CMakeLists.txt
├── CMakePresets.json
├── CPPs
    ├── Program3.cpp // 要运行的示例代码
    ├── Program3.txt // CMake模板自带的文件
├── Hs
    ├── Program3.h // CMake模板自带的头文件
├── out

当前错误 #

Severity    Code    Description Project File    Line    Suppression State   Details
Error   C1083   Cannot open include file: 'SFML/Graphics.hpp': No such file or directory    C:\Users\saled\OneDrive\Desktop\GameDev\StrategieLLC\1stAttempt\Program3\out\build\x64-debug\Program3   C:\Users\saled\OneDrive\Desktop\GameDev\StrategieLLC\1stAttempt\Program3\CPPs\Program3.cpp  1       

尝试过的命令 #

• 错误用法1：

target_include_directories({CMAKE_SOURCE_DIR} ../DevLibrariesUsed/SFML-2.6.1-windows-vc17-64-bit/SFML-2.6.1/include/SFML)

• 错误用法2：

target_include_directories(Program3 ../DevLibrariesUsed/SFML-2.6.1-windows-vc17-64-bit/SFML-2.6.1/include/SFML)

• 错误用法3：

include_directories(Program3 ../DevLibrariesUsed/SFML-2.6.1-windows-vc17-64-bit/SFML-2.6.1/include/SFML)

注：..指向项目与DevLibrariesUsed库目录的公共父目录，目前手动链接.lib文件可以成功：

target_link_libraries(Program3 ../DevLibrariesUsed/SFML-2.6.1-windows-vc17-64-bit/SFML-2.6.1/lib/sfml-window.lib)

解决方案 #

核心问题 #

你指定的头文件路径多了一层/SFML，代码里写的是#include <SFML/Graphics.hpp>，编译器需要在搜索路径下找到SFML文件夹，因此应该把搜索路径指向SFML的include目录，而非include/SFML。

正确配置方式 #

方式1：使用target_include_directories（推荐，现代CMake用法）

在CMakeLists.txt中，先确保已经定义了目标（比如add_executable(Program3 CPPs/Program3.cpp ...)），再添加：

target_include_directories(Program3 PUBLIC
    ${CMAKE_SOURCE_DIR}/../DevLibrariesUsed/SFML-2.6.1-windows-vc17-64-bit/SFML-2.6.1/include
)

• PUBLIC表示该路径会被目标本身及依赖该目标的其他目标使用，可根据需求替换为PRIVATE或INTERFACE。
• 使用${CMAKE_SOURCE_DIR}构造绝对路径，避免相对路径在不同构建目录下的歧义。

方式2：使用include_directories（旧版CMake用法）

如果要设置全局包含路径，直接写：

include_directories(
    ${CMAKE_SOURCE_DIR}/../DevLibrariesUsed/SFML-2.6.1-windows-vc17-64-bit/SFML-2.6.1/include
)

注意include_directories无需指定目标名，它会作用于所有后续定义的目标。

额外建议 #

为了更规范，推荐使用CMake的find_package自动查找SFML库，无需手动指定头文件和库文件路径，示例：

find_package(SFML 2.6 COMPONENTS window graphics system REQUIRED)
target_link_libraries(Program3 SFML::window SFML::graphics SFML::system)

使用前需确保SFML路径能被CMake找到，或通过CMAKE_PREFIX_PATH指定SFML的安装目录。

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