Arch系Linux下如何配置链接SDL2库解决编译链接错误

报错原因 #

你遇到的未定义引用（indefinite link）错误是编译时未添加SDL2链接参数导致的，和库文件位置无关。Arch官方源安装的sdl2包遵循Linux标准文件系统布局：

• 头文件默认存放在/usr/include/SDL2
• 动态链接库默认存放在/usr/lib
  以上两个路径都是GCC/G++默认的搜索路径，不需要手动把依赖文件拷贝到项目根目录。

具体解决步骤 #

1. 确认软件包安装 #

首先确认你已经安装了官方源的SDL2基础包，执行以下命令安装（已安装可跳过）：

sudo pacman -S sdl2

2. 命令行正确编译方式 #

不要直接用裸g++ main.cpp命令编译，借助系统自带的pkg-config工具自动获取SDL2的编译、链接参数即可，正确编译命令如下：

g++ main.cpp -o sdl2_demo $(pkg-config --cflags --libs sdl2)

参数说明：

• pkg-config --cflags sdl2：自动输出SDL2头文件搜索路径的编译参数
• pkg-config --libs sdl2：自动输出需要链接的SDL2库文件参数
  执行完上述命令生成的sdl2_demo可执行文件即可正常运行，弹出保留2秒的SDL2窗口。

3. VSCode开发环境配置 #

如果要在VSCode中直接编译运行不需要手动输命令，修改C/C++扩展的编译配置即可：

• 打开项目下的.vscode/tasks.json文件，将编译任务的command和args替换为上述带pkg-config的编译命令
• 如需修复代码提示找不到头文件的问题，在.vscode/c_cpp_properties.json的includePath字段中添加"/usr/include/SDL2"即可

额外提示 #

你提供的测试代码中定义的SDL_Surface * screen变量未被使用，编译时会触发未使用变量警告，删除该行即可消除警告，不影响程序功能。

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