使用g++/gcc手动链接GLFW编译程序时遇未定义引用错误

问题情况 #

项目结构：

project/
  main.cpp
  glfw/
    glfw3.h
    glfw3.lib

main.cpp直接使用GLFW官方文档的示例代码：

#include <glfw3.h>

int main(void)
{
    GLFWwindow *window;

    /* Initialize the library */
    if (!glfwInit())
        return -1;

    /* Create a windowed mode window and its OpenGL context */
    window = glfwCreateWindow(640, 480, "Hello World", NULL, NULL);
    if (!window)
    {
        glfwTerminate();
        return -1;
    }

    /* Make the window's context current */
    glfwMakeContextCurrent(window);

    /* Loop until the user closes the window */
    while (!glfwWindowShouldClose(window))
    {
        /* Render here */
        glClear(GL_COLOR_BUFFER_BIT);

        /* Swap front and back buffers */
        glfwSwapBuffers(window);

        /* Poll for and process events */
        glfwPollEvents();
    }

    glfwTerminate();
    return 0;
}

使用以下命令编译：

g++ main.cpp -o main.exe -Lglfw -Iglfw -lopengl32 -lglfw3

出现的错误信息：

C:\Users\x\AppData\Local\Temp\ccqBTKoM.o:main.cpp:(.text+0x17): undefined reference to `glfwInit'
C:\Users\x\AppData\Local\Temp\ccqBTKoM.o:main.cpp:(.text+0x56): undefined reference to `glfwCreateWindow'
C:\Users\x\AppData\Local\Temp\ccqBTKoM.o:main.cpp:(.text+0x64): undefined reference to `glfwTerminate'
C:\Users\x\AppData\Local\Temp\ccqBTKoM.o:main.cpp:(.text+0x76): undefined reference to `glfwMakeContextCurrent'
C:\Users\x\AppData\Local\Temp\ccqBTKoM.o:main.cpp:(.text+0x81): undefined reference to `glfwWindowShouldClose'
C:\Users\x\AppData\Local\Temp\ccqBTKoM.o:main.cpp:(.text+0xa6): undefined reference to `glfwSwapBuffers'
C:\Users\x\AppData\Local\Temp\ccqBTKoM.o:main.cpp:(.text+0xab): undefined reference to `glfwPollEvents'
C:\Users\x\AppData\Local\Temp\ccqBTKoM.o:main.cpp:(.text+0xb2): undefined reference to `glfwTerminate'
collect2.exe: error: ld returned 1 exit status

问题根源和解决办法 #

1. 库的编译器不兼容（最核心原因） #

你当前使用的glfw3.lib大概率是Visual Studio编译生成的静态库，而你用的是MinGW的g++链接器——两者的二进制库格式不兼容，导致链接器无法识别库中的函数符号。

解决方式：

• 去GLFW官网下载对应MinGW版本的预编译库，或者自行用MinGW编译GLFW源码：
  1. 下载GLFW源码包，用CMake配置生成MinGW Makefiles；
  2. 打开MinGW终端，进入编译目录执行mingw32-make，编译完成后会得到libglfw3.a；
  3. 替换掉glfw/目录下的glfw3.lib为libglfw3.a，再用原命令编译即可（g++会自动识别libxxx.a格式的库）。

2. 缺少静态库宏定义 #

如果使用静态库链接，必须在包含GLFW头文件之前定义GLFW_STATIC，否则编译器会默认按动态库方式查找符号，自然会出现未定义引用。

修改main.cpp开头：

#define GLFW_STATIC
#include <glfw3.h>

// 后续代码保持不变

3. 链接路径或顺序问题 #

g++的链接器对库的顺序有要求，被依赖的库要放在后面，不过你原命令的顺序是正确的。如果还是不行，可以直接指定库文件路径来链接：

g++ main.cpp -o main.exe -Iglfw -lopengl32 glfw/libglfw3.a

（前提是库文件为MinGW编译版本）

4. 检查库文件的正确性 #

确认glfw/目录下确实存在对应的库文件，且文件名正确——MinGW编译的静态库命名格式为libxxx.a，不要和Visual Studio的xxx.lib搞混。

验证步骤 #

1. 替换为MinGW版本的GLFW库；
2. 在代码中添加GLFW_STATIC宏定义；
3. 使用正确的编译命令执行；
4. 确认库文件路径和文件名无误。

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