XCode12引入Allegro库提示'allegro5\allegro.h file not found'报错求助

1. 修正头文件路径分隔符 #

你当前代码里使用的是Windows风格的反斜杠\作为路径分隔符，而macOS属于类Unix系统，必须使用正斜杠/作为路径分隔符，把所有Allegro相关引入语句修改为如下格式：

#include <allegro5/allegro.h>
#include <allegro5/allegro_font.h>
#include <allegro5/allegro_acodec.h>
#include <allegro5/allegro_audio.h>

2. 匹配Homebrew安装路径 #

• 若使用Intel架构Mac的情况下，Homebrew默认路径为/usr/local，原有路径配置正确
• 若使用Apple Silicon（M1/M2/M3等）系列Mac的情况下，Homebrew默认安装路径为/opt/homebrew，你需要将Header Search Path修改为/opt/homebrew/include/**，Library Search Path修改为/opt/homebrew/lib/**

3. 检查构建设置生效范围 #

• 进入Xcode构建设置页面搜索Header Search Paths选项时，顶部筛选器要选择All而非默认的Basic，否则自定义配置不会生效
• 确认你修改的是Target级别的构建设置，而非仅修改了Project级别的设置，Target级别配置优先级更高

4. 验证头文件实际存在 #

打开终端执行对应命令确认头文件确实存在：

• Intel Mac执行：ls /usr/local/include/allegro5/，检查是否能列出allegro.h等目标文件
• Apple Silicon Mac执行：ls /opt/homebrew/include/allegro5/，检查是否能列出allegro.h等目标文件

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