Xcode链接OpenGL库时提示‘OpenGL/gl.h’文件未找到的问题求助

我来帮你一步步排查这个困扰你的问题——你已经做了不少操作但还是碰到头文件找不到的错误，咱们从几个容易忽略的细节入手：

• 确认框架添加的正确姿势
  别只在项目级的框架区域添加，一定要给对应的Target做配置：

  1. 选中你的主Target，进入Build Phases -> Link Binary With Libraries
  2. 点击+号，搜索并添加系统自带的OpenGL.framework（如果搜不到，就选Add Other -> 导航到/System/Library/Frameworks/OpenGL.framework）
  3. 同时在Build Settings里检查Framework Search Paths，添加$(SDKROOT)/System/Library/Frameworks这个变量，避免硬编码路径导致的SDK版本适配问题

• 修正头文件引用与搜索路径
  代码里的头文件引用要确保是<OpenGL/gl.h>（尖括号表示搜索系统头路径），如果写成了"OpenGL/gl.h"（引号会优先搜项目内路径），赶紧改过来。另外在Build Settings的Header Search Paths里，手动添加$(SDKROOT)/System/Library/Frameworks/OpenGL.framework/Headers，直接指向gl.h所在的目录，让Xcode精准找到它。

• 同步chai3d子项目的配置
  既然你用到了chai3d和libchai3d子项目，一定要保证它们的配置和主项目一致：

  1. 打开libchai3d的.xcodeproj，给它的Target也做同样的框架添加和路径设置（和主Target步骤一样）
  2. 在主项目的Build Phases -> Target Dependencies里，把libchai3d的Target加进去，确保编译顺序是先编译依赖库再编译主项目
  3. 关于OpenGL 2.1的需求：macOS系统自带的OpenGL框架已经包含2.1版本，不需要额外下载，只要在chai3d的配置里没有强制指定更高版本的宏定义就行（可以检查chai3d的头文件里有没有类似#define GL_GLEXT_PROTOTYPES这类可能影响版本的定义）

• 检查链接器标志的有效性
  你添加的-framework OpenGL要确保是在Target的Build Settings -> Other Linker Flags里设置的（项目级设置虽然会继承，但Target级的优先级更高）。另外别加冲突的标志，比如不小心加了-framework OpenGLES，这会让Xcode混淆搜索路径。

• 清理缓存彻底重建
  Xcode的缓存经常会搞出奇怪的问题：

  1. 按住Option键点击顶部菜单栏的Product，选择Clean Build Folder
  2. 再打开Window -> Projects，选中你的项目，点击Delete Derived Data，彻底清空缓存
  3. 重启Xcode后再重新编译项目

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