VSCode无法识别CMake项目Include路径，编译正常求解决建议

我有一个用于学习的简易CMake C++项目，可正常编译运行，但VSCode无法找到头文件的包含路径，预期VSCode能从CMake文件自动获取相关信息。

项目CMake配置 #

根目录CMakeLists.txt #

cmake_minimum_required(VERSION 3.24.2)
project(SIMPLE_ENGINE CXX)
add_subdirectory(engine)
add_subdirectory(game)

game模块CMakeLists.txt #

cmake_minimum_required(VERSION 3.24.2)
project(GAME CXX)

add_executable(
    game
    src/main.cpp
)

target_link_libraries(
    game
    engine
)

set_property(TARGET game PROPERTY CXX_STANDARD 20)

engine模块CMakeLists.txt #

cmake_minimum_required(VERSION 3.24.2)
project(ENGINE CXX)

add_library(
    engine
    include/base/window.h
    src/base/window.cpp
    include/base/engine.h
    src/base/engine.cpp
)

target_include_directories(
    engine
    PUBLIC
    ${CMAKE_CURRENT_SOURCE_DIR}/include
)

target_link_libraries(
    engine
    glfw
    GLEW
    GL
)

set_property(TARGET engine PROPERTY CXX_STANDARD 20)

解决建议 #

• 安装并启用CMake Tools扩展：VSCode官方的「CMake Tools」是识别CMake配置的核心，必须安装，安装后重启VSCode。
• 生成编译数据库：
  1. 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入「CMake: Configure」，选择对应编译器（如GCC/Clang）完成配置。
  2. 配置后CMake会在构建目录生成compile_commands.json，VSCode的C/C++扩展会自动读取该文件获取头文件路径和编译参数。
• 手动指定编译数据库路径（可选）：
  如果自动读取失败，在项目的.vscode/c_cpp_properties.json中添加配置（无此文件可通过命令面板「C/C++: Edit Configurations (UI)」生成）：

  {
      "configurations": [
          {
              "name": "Linux", // 按需替换为Windows/macOS
              "compileCommands": "${workspaceFolder}/build/compile_commands.json", // 替换为你的实际构建目录
              "cppStandard": "c++20"
          }
      ],
      "version": 4
  }
  

• 确认构建目录正确性：若使用自定义构建目录，需保证compile_commands.json路径与配置一致，可通过「CMake: Set Build Directory」指定路径。
• 重新加载窗口：完成上述操作后，执行命令面板的「Developer: Reload Window」，让VSCode重新加载所有配置。

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