GLFW初始化失败主因是库未正确链接或运行时找不到动态库：Windows需将glfw3.dll放同目录，Linux/macOS需设置库路径，CMake须用find_package(glfw3 REQUIRED)并target_link_libraries；黑屏因glad加载顺序错，须先glfwMakeContextCurrent再gladLoadGLLoader；版本不匹配导致函数未定义，应校验glfwGetVersionString与头文件版本一致；窗口关闭后须调glfwTerminate()释放资源。
GLFW初始化失败：glfwInit() 返回 0 怎么办
这通常不是代码写错了，而是 GLFW 库根本没被正确链接或运行时找不到动态库。Windows 下常见于没把 glfw3.dll 放到可执行文件同目录；Linux/macOS 则多因没设置 LD_LIBRARY_PATH 或 DYLD_LIBRARY_PATH。CMake 用户容易漏掉 find_package(glfw3 REQUIRED) 或忘记在 target_link_libraries 中显式加入 glfw。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 确认
glfwInit()前没调用过任何其他 OpenGL 函数（比如glGetString），否则会静默失败 - Windows 上用
Dependency Walker或ldd（WSL）检查可执行文件是否真正绑定了glfw符号 - macOS 若用 Homebrew 安装，确保链接的是
/usr/local/lib/libglfw.3.dylib而非系统自带旧版
创建窗口后黑屏 / 无渲染：glfwMakeContextCurrent() 和 gladLoadGLLoader() 的顺序不能错
GLFW 创建窗口只是分配了上下文资源，但 OpenGL 函数指针还没加载——尤其是现代 OpenGL（3.3+）必须靠 glad、glew 等加载器手动绑定。如果先调 glClearColor 再加载 glad，程序可能崩溃或静默失效。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 严格按顺序：创建窗口 →
glfwMakeContextCurrent(window)→ 调gladLoadGLLoader((GLADloadproc)glfwGetProcAddress)→ 检查返回值是否非 0 - 别用
#include混搭 GLFW，GLEW 会干扰 GLFW 的上下文管理，尤其在多窗口场景下易出Invalid operation - macOS 上若用 Core Profile，需在创建窗口前加：
glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE)
编译时报错找不到 glfwGetTime 或 glfwSetFramebufferSizeCallback
这是头文件和链接库版本不匹配的典型表现。例如项目包含的是 GLFW 3.2 的 glfw3.h，但链接了 3.1 的 libglfw.a，而 glfwGetTime 是 3.2 才引入的。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用
glfwGetVersionString()在运行时打印实际加载的版本，和头文件宏GLFW_VERSION_MAJOR对比 - CMake 中避免硬写
find_library(GLFW NAMES glfw)，改用find_package(glfw3 CONFIG REQUIRED)，让 CMake 自动匹配头文件与库路径 - MinGW 用户注意：官网预编译包是 MSVC ABI，必须用
mingw-w64自编译版，否则符号解析失败
窗口关闭后程序卡死：没调 glfwTerminate() 或残留回调未清除
GLFW 不是“用完即焚”型库——它内部持有线程、事件队列、输入状态等资源。不调 glfwTerminate() 可能导致下次运行时 glfwInit() 失败，或在某些 Linux 桌面环境（如 Wayland）下锁死输入设备。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 确保
glfwTerminate()在所有glfwDestroyWindow()之后调用，且只调一次 - 若注册了
glfwSetKeyCallback或glfwSetCursorPosCallback，退出前不必手动清空，但回调函数内不要再访问已销毁的窗口指针 - 调试时可在
main结尾加std::cout ，确认控制流确实走到终止逻辑
