macOS Ventura下SDL2库使用：C文件头引用及编译问题解决

问题场景 #

在macOS Ventura系统上通过brew install sdl2安装SDL2库后，编写C代码时不清楚该引入哪些头文件，先后尝试了#include <SDL.h>、<SDL2.h>、<SDL/SDL2.h>、<SDL/SDL2_main.h>，并使用命令gcc sdl-config --cflags --libs -o main.x main.c编译，但均未成功，最终通过在Makefile中添加编译标志CFLAGS = -Wall -Wextra -std=c11 -I/usr/local/include/SDL2解决了问题。

正确的头文件引入方式 #

根据Homebrew安装SDL2的默认路径（/usr/local/include/SDL2），有两种引入方式：

• 不额外指定头文件搜索路径时，需完整写出路径：

  #include <SDL2/SDL.h>
  

• 如果在编译时添加了-I/usr/local/include/SDL2（将SDL2目录加入头文件搜索路径），可以直接简化为：

  #include <SDL.h>
  

编译命令的注意事项 #

之前使用sdl-config是问题根源之一——Homebrew安装的SDL2对应的配置工具是sdl2-config（sdl-config通常对应SDL 1.x版本）。正确的编译命令应该是：

gcc $(sdl2-config --cflags --libs) -o main.x main.c

使用这个命令时，sdl2-config --cflags会自动加入正确的头文件搜索路径，无需手动添加-I参数，此时头文件用#include <SDL2/SDL.h>即可正常编译。

基于Makefile的解决方案 #

如果倾向于用Makefile管理编译，可以参考以下两种配置：

方式一：借助sdl2-config自动生成编译/链接参数 #

CFLAGS = -Wall -Wextra -std=c11 $(shell sdl2-config --cflags)
LDFLAGS = $(shell sdl2-config --libs)

main.x: main.c
	gcc $(CFLAGS) -o $@ $^ $(LDFLAGS)

方式二：手动指定路径（即你采用的解决方式） #

CFLAGS = -Wall -Wextra -std=c11 -I/usr/local/include/SDL2
LDFLAGS = -L/usr/local/lib -lSDL2

main.x: main.c
	gcc $(CFLAGS) -o $@ $^ $(LDFLAGS)

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