如何让Qt Creator显示CMake target_include_directories关联的头文件？

要让Qt Creator自动识别并显示头文件，核心是让CMake明确关联头文件到目标，同时正确配置包含路径。下面是具体的CMakeLists.txt编写方案和要点：

示例CMakeLists.txt（Qt6项目） #

cmake_minimum_required(VERSION 3.20)
project(MyQtApplication)

# 引入Qt组件，根据项目需求调整组件列表
find_package(Qt6 REQUIRED COMPONENTS Widgets)
qt_standard_project_setup()

# 添加目标时，**必须显式列出所有需要Qt Creator识别的头文件**
add_executable(MyQtApplication
    main.cpp
    mainwindow.cpp
    mainwindow.h
    core/utils.h
    core/logger.h
)

# 配置目标的包含目录，PRIVATE表示仅当前目标内部使用这些路径
target_include_directories(MyQtApplication
    PRIVATE
        ${CMAKE_CURRENT_SOURCE_DIR}
        ${CMAKE_CURRENT_SOURCE_DIR}/core  # 子目录头文件路径
)

# 链接Qt库
target_link_libraries(MyQtApplication PRIVATE Qt6::Widgets)

关键要点 #

• 显式添加头文件到目标源列表：CMake编译时不需要显式列出头文件，但Qt Creator的CMake解析器依赖这个关联关系来识别头文件归属。所以add_executable或add_library时，要把所有需要显示的.h/.hpp文件和源文件一起列出来。
• 正确使用target_include_directories的作用域：用PRIVATE标记仅当前目标需要的路径，PUBLIC用于需要传递给依赖目标的路径，INTERFACE则只给依赖目标用。确保所有头文件所在目录都被覆盖。
• 启用Qt标准配置：Qt6的qt_standard_project_setup()会自动处理AUTOMOC、AUTOUIC等配置，同时帮助Qt Creator更好地解析项目结构；如果是Qt5项目，需要手动开启set(CMAKE_AUTOMOC ON)、set(CMAKE_AUTOUIC ON)。
• 避免批量glob头文件：虽然可以用file(GLOB HEADERS *.h)批量获取头文件，但这种方式不会自动追踪新增文件，修改后需要重新触发CMake配置，显式列出更稳定可靠。

库项目适配 #

如果是静态库/动态库项目，逻辑类似，只需把add_executable换成add_library，并根据需求调整target_include_directories的作用域（比如用PUBLIC让依赖库的项目也能找到头文件）：

add_library(MyCoreLibrary STATIC
    corelib.cpp
    corelib.h
    helper.h
)

target_include_directories(MyCoreLibrary
    PUBLIC
        ${CMAKE_CURRENT_SOURCE_DIR}  # 依赖该库的项目能直接引用头文件
)

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