glfw和glad不是“装”上去的，而是需确保编译器能找到头文件、链接器能找到.lib/.a库、运行时能加载.dll/.so；绝大多数问题源于这三处路径未正确配置。
直接说结论：GLFW 和 GLAD 不是“装”上去的，而是要让编译器在 gcc 或 cl 编译时能找到头文件、链接器能找到 .lib 或 .a、运行时能加载 glfw3.dll 或 libglfw.so。卡住的绝大多数问题，都出在这三处路径没对上。
头文件找不到：glad/glad.h 或 GLFW/glfw3.h 报错
这不是库没下载，是编译器根本没被告诉“去哪找”。VSCode 的 c_cpp_properties.json、Visual Studio 的“包含目录”、或 Makefile 里的 -I 参数，必须显式指向你解压后的 include 路径。
- GLFW 头文件在下载包的
include/目录下（不是src/）；GLAD 的在生成 ZIP 解压后的include/里 - 两个库的
include要**同时加**，顺序无关，但路径不能写错，比如D:\dev\glfw\include和D:\dev\glad\include - VSCode 用户注意：
c_cpp_properties.json中的includePath是数组，别漏了逗号，也别把路径写成相对路径却没配cwd - Linux/macOS 下用
pkg-config --cflags glfw可自动获取正确路径，比手写-I更可靠
链接失败：undefined reference to 'glfwInit' 或类似符号
编译通过但链接报错，说明头文件找到了，但静态库（glfw3.lib / libglfw.a）没被链接器看见，或者动态库（glfw3.dll / libglfw.so）没被加载。
- 确保你在链接阶段显式加了
glfw3和opengl32（Windows）或glfw和GL（Linux/macOS）——CMake 里是target_link_libraries(myapp glfw ${OPENGL_LIBRARIES}) - Windows 上 MinGW 用户注意：
libglfw.a和glfw3.dll是两回事。调试时如果用了-lglfw链静态库，就不用复制 DLL；但如果链接的是dllimport版本（如预编译的glfw3.lib），就必须把glfw3.dll放到可执行文件同目录 - Linux 下记得
sudo apt install libglfw3-dev，它会把头文件和.so都装进系统路径，省去手动配置
gladLoadGLLoader 返回 0：上下文创建成功但 GL 函数全为空指针
这是 GLAD 初始化失败最典型的症状，90% 是因为 glfwMakeContextCurrent(window) 没调，或调得太晚——必须在 gladLoadGLLoader 之前完成上下文绑定。
- 检查代码顺序：先
glfwCreateWindow→ 再glfwMakeContextCurrent(window)→ 最后gladLoadGLLoader((GLADloadproc)glfwGetProcAddress) - 确认
glfwWindowHint设置了正确的 OpenGL 版本，比如GLFW_CONTEXT_VERSION_MAJOR = 3和GLFW_CONTEXT_VERSION_MINOR = 3；GLAD 生成时也要选完全一致的版本和CoreProfile - Mac 用户注意：macOS 10.14+ 默认不支持 OpenGL，需强制启用
glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE)并使用GLFW_OPENGL_CORE_PROFILE - 如果仍失败，加一句
std::cout 看是否是窗口创建本身出了问题
运行时报 找不到 glfw3.dll 或黑屏无响应
编译链接全过，但双击 exe 崩溃或窗口一闪而逝，本质是运行时依赖缺失或初始化逻辑有误。
- Windows 下
glfw3.dll必须和你的.exe在同一目录，或在系统PATH里——别只往mingw64/bin里扔，那个路径对 IDE 启动的程序有效，但对双击无效 - 检查
main函数末尾有没有glfwTerminate()，没有不会导致崩溃，但资源泄漏可能影响后续运行 - 黑屏常见于忘记调
glViewport或glClear，或着色器编译失败却没检查glGetShaderiv(..., GL_COMPILE_STATUS, ...) - VSCode 调试时若用
launch.json，确保cwd设为输出目录，否则 DLL 找不到
最容易被忽略的一点：GLAD 生成页面里选的 OpenGL 版本、Profile（Core/Compatibility）、语言（C/C++）必须和代码中 glfwWindowHint 完全一致。差一个数字或 Profile 类型，gladLoadGLLoader 就会静默失败，且没有任何错误提示。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
