如何解决SDL2/SDL.h: No such file or directory编译错误？

1. 核实头文件目录结构 #

确认src/include下存在SDL2子文件夹，且该文件夹内包含SDL.h。正确路径应为src/include/SDL2/SDL.h：

• 若头文件直接放在src/include下，要么把所有SDL头文件移入新建的SDL2子文件夹，要么将代码里的#include <SDL2/SDL.h>改为#include <SDL.h>。

2. 排查Makefile参数 #

当前Makefile的-I src/include参数是正确的，但需注意：

• 确保你是通过make命令执行编译，而非手动输入省略参数的g++命令；
• 若相对路径存在歧义，可替换为绝对路径，比如-I D:/your-project-path/src/include。

3. 确认SDL2与MinGW版本匹配 #

你使用64位MinGW，必须对应安装64位SDL2开发库：

• 重新下载对应版本的SDL2，解压后将include目录下的SDL2文件夹复制到项目的src/include；
• 将lib目录下的libSDL2.a、libSDL2main.a、SDL2.dll复制到项目的src/lib。

4. 修正IDE的包含路径配置 #

以VS Code为例，修改.vscode/c_cpp_properties.json：

{
    "configurations": [
        {
            "includePath": [
                "${workspaceFolder}/**",
                "${workspaceFolder}/src/include"
            ],
            "compilerPath": "C:/mingw64/bin/g++.exe", // 替换为你的64位MinGW的g++路径
            "cppStandard": "c++17",
            "intelliSenseMode": "gcc-x64"
        }
    ],
    "version": 4
}

关键是指定正确的64位编译器路径，确保IDE的IntelliSense和实际编译使用同一套环境。

5. 手动验证编译命令 #

在终端直接执行以下命令测试：

g++ -I src/include -L src/lib -o main main.cpp -lmingw32 -lSDL2main -lSDL2

若仍报错，检查是否拼写错误，或SDL库文件是否完整。

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