如何用G++静态链接GL/gl.h与GL/glut.h？编译报错求解

错误原因 #

• libGL静态库默认缺失：Linux发行版中，系统提供的OpenGL库（libGL）几乎都是动态库（libGL.so），静态版本（libGL.a）不会默认安装，甚至很多发行版官方不提供——因为OpenGL和硬件驱动深度绑定，静态链接会导致程序无法适配不同显卡驱动，兼容性极差。
• 链接顺序错误：静态链接时，库的依赖顺序必须严格遵循「被依赖的库放在后面」，glut依赖GL，所以-lglut要放在-lGL之前，否则链接器会找不到依赖符号。
• freeglut编译未生成静态库：默认编译freeglut只会生成动态库，必须显式指定静态编译的CMake参数，否则系统里没有libglut.a供静态链接。

正确静态链接步骤 #

Linux 平台 #

1. 编译并安装静态版freeglut
   下载freeglut 3.4.0源码后，用CMake指定静态编译：

   # 创建编译目录并配置静态编译参数
   cmake -S freeglut-3.4.0 -B build -DFREEGLUT_STATIC=ON -DFREEGLUT_BUILD_DEMOS=OFF
   # 编译源码
   cmake --build build
   # 安装到系统库路径（需sudo权限）
   sudo cmake --install build
   

   执行完成后，系统会生成并安装静态库libglut.a。

2. 编译程序（分两种场景）

   • 场景1：仅静态链接freeglut，动态链接libGL（推荐，兼容性最好）
     这种方式能解决freeglut的依赖问题，而libGL是Linux系统几乎都会预装的动态库：

     g++ thing.cpp -Wall -o thing -static-libgcc -static-libstdc++ -lglut -lGL
     

   • 场景2：强制全静态链接（不推荐，兼容性差）
     先尝试安装mesa的静态OpenGL库（仅部分发行版支持，如Ubuntu/Debian）：

     sudo apt install libgl1-mesa-static
     

     然后用正确的链接顺序编译：

     g++ thing.cpp -Wall -o thing -static -lglut -lGL -static-libgcc -static-libstdc++
     

     注意：全静态链接的程序可能无法在不同显卡驱动的机器上运行，甚至启动失败。

Windows 平台（MinGW环境） #

1. 安装静态版freeglut：直接下载MinGW适配的freeglut静态开发包，或用CMake编译时指定-DFREEGLUT_STATIC=ON生成静态库。
2. 编译时使用静态glut库，链接Windows原生OpenGL库：

   g++ thing.cpp -Wall -o thing.exe -static-libgcc -static-libstdc++ -lfreeglut_static -lopengl32
   

   这里用-lfreeglut_static代替-lglut，Windows的OpenGL库为opengl32.lib，必须显式链接。

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