Windows下直接添加GLFW源码至VS项目编译报错，求排查解决

问题背景 #

我尝试不先编译GLFW为二进制.lib文件，直接把全部GLFW源码文件添加到Visual Studio 2022项目中，操作步骤如下：

• 创建Visual Studio 2022项目
• 添加GLFW源码文件
• 引入头文件：

  #include <glad/gl.h>
  #include <GLFW/glfw3.h>
  

• 添加预处理器定义：_GLFW_WIN32;_GLFW_OPENGL_LIBRARY
• 编译后出现大量错误，包括：
  • C1083 无法打开包含文件: X11/cursorfont.h: No such file or directory
  • C2039 "x11": 不是"_GLFWlibrary"的成员
  • C4013 DisplayWidthMM: 未定义；假定外部返回类型为"int"
  • C2065 screens: 未声明的GLFW标识符
  • C1083 无法打开包含文件: unistd.h: No such file or directory

另外注意到GLFW的x11_windows.c文件中尝试引入<X11/cursorfont.h>，但该文件不在GLFW源码里，疑惑为什么Windows下GLFW会启用X11相关代码。

问题原因与解决方法 #

1. 错误引入非Windows平台源码文件
   GLFW针对不同操作系统提供了专属实现代码，Windows下不需要加入X11、Wayland等其他平台的文件（比如x11_*.c、wayland_*.c这类）。你把全部源码都加入项目，编译器会同时编译Windows和X11的代码，导致平台逻辑冲突，还会找不到X11专属的头文件（这些头文件属于Linux/Unix系统，Windows上不存在）。

• 解决：只保留GLFW中Windows相关及通用源码文件：
  • Windows专属文件：所有win32_*.c（如win32_init.c、win32_window.c、win32_monitor.c等）
  • 通用核心文件：context.c、init.c、input.c、monitor.c、window.c
  • 可选文件：如果不用Vulkan/EGL/OSMesa，可去掉vulkan.c、egl_context.c、osmesa_context.c

2. 补充预处理器定义
   虽然添加了_GLFW_WIN32，但需确保没有其他平台的宏定义，同时补充必要项：

• 确保预处理器定义中无_GLFW_X11、_GLFW_WAYLAND等其他平台宏
• 添加_CRT_SECURE_NO_WARNINGS（避免VS对C标准库函数的安全警告，可选但推荐）
• 保留_GLFW_OPENGL_LIBRARY，它用于让GLFW自动链接系统OpenGL库

3. 配置头文件路径
   将GLFW源码根目录下的include文件夹添加到项目的附加包含目录（项目属性->C/C++->常规->附加包含目录），确保编译器能正确找到GLFW/glfw3.h。

4. 链接Windows系统库
   Windows下GLFW依赖系统库，需在项目的链接器->输入->附加依赖项中添加：user32.lib;gdi32.lib;kernel32.lib

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