M1 Mac下使用g++编译SDL2项目时遇链接错误求助

问题根源 #

报错ld: library not found for -lSDL2是因为链接器无法定位SDL2库文件，核心原因有两点：

• 编译命令中链接库参数的顺序错误：链接器按输入顺序处理文件，库参数需放在源文件之后
• 链接器默认搜索路径未包含SDL2的库目录

解决方案 #

方案1：调整编译命令参数顺序并指定库路径 #

修改编译命令，将-Llib（指定库搜索路径）和-lSDL2移至源文件之后：

g++ -std=c++11 -Wall -O0 -g -Iinclude src/main.cpp -o build/debug/tst -Llib -lSDL2

注：-Llib告诉链接器去当前目录的lib子目录查找库，你的lib/SDL2是指向brew安装路径的软链接，这样链接器就能找到对应库文件

方案2：用pkg-config自动生成编译链接参数 #

brew安装的SDL2自带pkg-config配置，该工具可自动生成正确的编译、链接参数，避免手动配置路径出错：

g++ -std=c++11 -Wall -O0 -g $(pkg-config --cflags SDL2) src/main.cpp -o build/debug/tst $(pkg-config --libs SDL2)

• pkg-config --cflags SDL2：自动输出SDL2的头文件路径参数
• pkg-config --libs SDL2：自动输出SDL2的库路径和链接库参数

方案3：验证软链接有效性 #

若上述方案无效，先检查软链接是否正常：

1. 查看include目录的软链接：

ls -l include/SDL2

2. 查看lib目录的软链接：

ls -l lib/SDL2

如果软链接失效，重新创建：

ln -sf /opt/homebrew/Cellar/sdl2/2.0.22/include/SDL2 include/SDL2
ln -sf /opt/homebrew/Cellar/sdl2/2.0.22/lib lib/SDL2

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