CMake构建含Glad/GLFW/ImGui的C++项目时GLFW头文件缺失错误

确认GLFW的CMake引入方式是否正确 #

• 若你通过系统包管理安装GLFW，必须用find_package让CMake定位它，GLFW不在默认路径时需手动指定配置目录：

  set(GLFW_DIR "/usr/local/lib/cmake/GLFW" CACHE PATH "GLFW config directory")
  find_package(GLFW REQUIRED)
  

• 若你将GLFW源码作为项目子模块/子目录引入，要通过add_subdirectory将其加入CMake构建流程：

  add_subdirectory(vendor/glfw) # 替换为你的GLFW源码实际路径
  

检查项目目标的链接与包含目录配置 #

• 你的可执行目标必须正确关联GLFW的头文件和库，CMake配置需补充以下内容：

  add_executable(YourApp main.cpp imgui_impl_glfw.cpp ...)
  
  # 使用find_package引入GLFW的情况
  target_include_directories(YourApp PRIVATE ${GLFW_INCLUDE_DIR})
  target_link_libraries(YourApp PRIVATE GLFW::GLFW)
  
  # 使用子目录引入GLFW的情况，直接链接glfw目标即可，CMake自动处理包含路径
  # target_link_libraries(YourApp PRIVATE glfw)
  

  注意务必将imgui_impl_glfw.cpp加入可执行目标的源文件列表。

检查ImGui实现文件的头文件引用格式 #

• 打开imgui_impl_glfw.cpp，确认GLFW头文件的引用是#include <GLFW/glfw3.h>；如果是#include "GLFW/glfw3.h"，要么将GLFW的include目录添加到项目包含路径，要么改为尖括号形式（更适配CMake管理的第三方库路径）。

手动编译验证头文件路径有效性 #

• 脱离CMake环境，用手动编译命令测试imgui_impl_glfw.cpp：

  g++ -c imgui_impl_glfw.cpp -I/path/to/glfw/include
  

  若该命令能成功编译，说明头文件路径无问题，故障出在CMake配置环节，需回头检查包含目录或链接设置。

清理CMake缓存重新生成构建文件 #

• 旧的CMake缓存可能残留错误路径，导致配置不生效：
  1. 删除构建目录下的CMakeCache.txt文件
  2. 清空构建目录内所有文件（如执行rm -rf build/*）
  3. 重新运行cmake ..生成新的Makefile，再执行make编译

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