macOS下OpenGL 3D魔方程序运行报错：freeglut无法打开显示

1. 补全X11依赖与环境变量 #

macOS无原生X11服务，freeglut依赖X11创建显示窗口：

• 安装XQuartz，完成后重启终端
• 检查DISPLAY环境变量：执行echo $DISPLAY，正常输出应为:0。若为空，手动设置：

  export DISPLAY=:0
  

  可将该命令写入~/.zshrc或~/.bash_profile，避免每次重启终端重复设置。

2. 替换freeglut为macOS原生GLUT #

macOS自带原生GLUT框架，与freeglut存在兼容性冲突，直接替换：

• 修改Makefile，将链接freeglut的参数（如-lglut）替换为-framework GLUT
• 同时确保链接原生OpenGL框架：添加-framework OpenGL
• 代码中若存在freeglut专属函数（如glutInitContextVersion），替换为原生GLUT支持的写法，或直接改用GLFW（更推荐）

3. 改用GLFW替代GLUT/freeglut #

GLFW在macOS上适配性更强，无需依赖X11，是更现代的窗口管理库：

• 替换代码中GLUT相关逻辑：
  • 初始化：glutInit(&argc, argv) → glfwInit()
  • 创建窗口：glutCreateWindow() → glfwCreateWindow(width, height, title, NULL, NULL)
  • 事件循环：glutMainLoop() → 改用while (!glfwWindowShouldClose(window)) { glfwPollEvents(); /* 渲染逻辑 */ }
• 修改Makefile，链接GLFW库：若通过brew安装，使用-lglfw；若为框架安装，使用-framework GLFW
• GLM的使用不受影响，可继续保留

4. 修正Makefile编译链接参数 #

确保Makefile适配macOS环境：

• 编译时添加最低版本指定：-mmacosx-version-min=10.15（可根据实际需求调整版本）
• 链接时优先使用原生框架，示例配置：

  CC = clang
  CFLAGS = -std=c++11 -mmacosx-version-min=10.15 -I/usr/local/include
  LDFLAGS = -framework OpenGL -lglfw -lglm
  

5. 验证第三方库安装路径 #

若通过brew安装freeglut、GLFW，确保编译时能找到头文件与库：

• 添加编译参数-I/usr/local/include（头文件路径）和-L/usr/local/lib（库文件路径）

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