CMake静态链接GLFW至可执行文件时提示找不到glfw3.h的问题

• 编译阶段报找不到GLFW/glfw3.h，且报错的文件路径末尾多了无效斜杠，本质是主程序目标没有关联到GLFW的头文件搜索路径，原配置存在两个核心问题：
  1. CMake语法对Windows路径的反斜杠存在转义解析逻辑，原写法L:\glfw-3.3.2中的单斜杠会被识别为转义字符，即使没有触发CMake本身的报错，实际也无法正确加载GLFW的目标属性
  2. 没有强制GLFW构建为静态库，也没有明确链接时的属性传递关系，导致GLFW内置的头文件包含路径没有自动传递给主程序

• 替换Windows路径的单斜杠为正斜杠，避免转义解析异常
• 补充强制关闭动态库构建的配置，实现真正的GLFW静态链接
• 链接时增加PRIVATE属性修饰，确保GLFW的接口属性（包括头文件路径、系统依赖）能正确传递给主程序
• 调整依赖查找顺序，减少CMake解析歧义

cmake_minimum_required(VERSION 3.0.0)
project(openGL VERSION 1.0.0)

# 强制全局关闭动态库构建，生成静态版本GLFW
set(BUILD_SHARED_LIBS OFF CACHE BOOL "" FORCE)
# 关闭GLFW冗余构建项，减少编译耗时
set(GLFW_BUILD_DOCS OFF CACHE BOOL "" FORCE)
set(GLFW_BUILD_TESTS OFF CACHE BOOL "" FORCE)
set(GLFW_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)

# 修正路径写法，使用正斜杠避免CMake转义解析异常
add_subdirectory(L:/glfw-3.3.2)

add_executable(main main.cpp)

# PRIVATE修饰确保GLFW的头文件路径、依赖配置自动传递给主程序
target_link_libraries(main PRIVATE glfw)

find_package(OpenGL REQUIRED)
target_link_libraries(main PRIVATE OpenGL::GL)

• 修正后CMake会自动关联GLFW源码目录下的include文件夹（该路径下直接存放GLFW/glfw3.h头文件），编译器搜索头文件时就能直接匹配到目标文件，不会再出现路径拼接错误、找不到头文件的问题
• 生成的glfw库为静态版本，最终主程序编译完成后不需要附带GLFW的动态库文件，满足静态链接的要求

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