如何在CMake与Qt Creator中消除头文件路径遍历？

你的配置失效主要有两个核心问题，修正后即可实现直接通过头文件名引用：

1. 目标名称错误 #

你在target_include_directories中使用了${PROJECT_NAME}，但实际生成可执行文件的目标是pageNavigatorTest，两者不匹配导致包含路径没有被应用到正确的目标上。

2. 路径拼接缺失斜杠 #

${CMAKE_CURRENT_SOURCE_DIR}与后续路径之间没有添加斜杠/，导致拼接后的路径格式错误（比如变成当前目录../../../../...这种无效路径）。

修正后的CMake配置 #

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

add_executable(pageNavigatorTest
    ../../../../UI/Controller/PageNavigator/PageNavigatorBase.cpp
    ../../../../UI/Controller/PageNavigator/PageNavigatorPT.cpp
    tst_pagenavigatortest.cpp)

# 修正目标名称和路径格式
target_include_directories(pageNavigatorTest
PUBLIC
    ${CMAKE_CURRENT_SOURCE_DIR}/../../../../UI/Controller/PageNavigator
)

add_test(NAME pageNavigatorTest COMMAND pageNavigatorTest)

额外注意事项 #

• 修改配置后，在Qt Creator中点击CMake菜单下的Reload CMake Project，确保配置被重新加载。
• 如果仍有问题，尝试清理构建目录后重新构建，避免旧的构建缓存影响。

可选优化（避免多层../） #

如果想减少路径中../的层级，可使用get_filename_component来更稳妥地定位目标目录，示例如下：

# 获取项目根目录（假设当前CMakeLists.txt位于tests/pageNavigatorTest下，根目录是上4层）
get_filename_component(ROOT_DIR ${CMAKE_CURRENT_SOURCE_DIR} DIRECTORY)
get_filename_component(ROOT_DIR ${ROOT_DIR} DIRECTORY)
get_filename_component(ROOT_DIR ${ROOT_DIR} DIRECTORY)
get_filename_component(ROOT_DIR ${ROOT_DIR} DIRECTORY)

target_include_directories(pageNavigatorTest
PUBLIC
    ${ROOT_DIR}/UI/Controller/PageNavigator
)

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