Windows10 MinGW环境下GLFW静态链接错误求助

环境配置 #

• 编译器：g++.exe (MinGW.org GCC-6.3.0-1) 6.3.0
• 操作系统：Windows10 Home（版本2009）
• 命令行：Powershell

代码文件 #

使用GLFW官网提供的示例代码Application.cpp：

#include <GLFW/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;
}

文件结构 #

项目目录结构如下：

├───build
│       glfw3.dll
│       libglfw3.a
│       libglfw3dll.a
│
├───Dependencies
│   └───GLFW
│       ├───include
│       │   └───GLFW
│       │           glfw3.h
│       │           glfw3native.h
│       │
│       ├───lib-mingw
│       │       glfw3.dll
│       │       libglfw3.a
│       │       libglfw3dll.a
│       │
│       └───lib-mingw-w64
│               glfw3.dll
│               libglfw3.a
│               libglfw3dll.a
│
└───src
        Application.cpp

编译命令 #

• 动态链接命令（可正常运行）：

  g++ -g -I.\Dependencies\GLFW\include\ .\src\Application.cpp -o .\build\Application.exe -L.\Dependencies\GLFW\lib-mingw\ -lglfw3dll -lopengl32
  

  疑问：动态链接时为何需要添加-lopengl32？GLFW官方文档未提及该参数。

• 静态链接命令（均失败）：
  1.

  g++ -g -I.\Dependencies\GLFW\include\ .\src\Application.cpp -o .\build\Application.exe -L.\Dependencies\GLFW\lib-mingw\ -lglfw3 -lopengl32
  

  g++ -g -I.\Dependencies\GLFW\include\ .\src\Application.cpp -o .\build\Application.exe -L.\Dependencies\GLFW\lib-mingw\ -lglfw3 -lopengl32 -lgdi32 -luser32 -lkernel32
  

错误信息 #

静态链接时出现大量未定义引用错误，例如__mingw_free、CreateDCW@16等，最终collect2.exe返回错误码1。

解决方案 #

1. 修复静态链接依赖问题 #

未定义引用错误的核心是静态链接GLFW时，缺失了部分依赖系统库，且库的链接顺序不符合MinGW链接器的解析规则。修改后的可行静态链接命令如下：

g++ -g -I.\Dependencies\GLFW\include\ .\src\Application.cpp -o .\build\Application.exe -L.\Dependencies\GLFW\lib-mingw\ -lmingw32 -lglfw3 -lopengl32 -lgdi32 -luser32 -lkernel32 -lwinmm

关键注意点：-lmingw32必须放在-lglfw3之前，因为MinGW链接器是按从左到右的顺序解析依赖，先处理的库可以被后序库引用。

2. 动态链接需-lopengl32的原因 #

GLFW内部会调用OpenGL原生API（比如代码中的glClear），而Windows平台的OpenGL实现是通过系统自带的opengl32.dll提供的。动态链接GLFW时，虽然GLFW动态库本身依赖opengl32.dll，但MinGW链接器不会自动传递该依赖，必须显式添加-lopengl32才能让链接器找到OpenGL相关符号。官方文档默认开发者了解Windows平台的OpenGL链接要求，因此未专门提及。

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