使用g++编译SDL2窗口代码时出现退出码-1错误求助

核心问题分析 #

这种情况大概率是编译命令缺少SDL2库的链接参数，或者VS Code的任务配置不正确，导致编译/链接失败但错误信息没被正常捕获。

解决步骤 #

1. 确保编译命令包含链接参数 #

编译SDL2程序必须显式链接SDL2库，g++命令需要添加对应的链接选项：

• Windows平台：需同时链接SDL2main和SDL2，命令示例：

  g++ your_code.cpp -o output.exe -I./Include -L./Lib -lSDL2main -lSDL2
  

• Linux/macOS平台：一般只需要链接SDL2，命令示例：

  g++ your_code.cpp -o output -I./Include -L./Lib -lSDL2
  

  其中-I指定头文件目录，-L指定库文件目录，根据你的实际文件夹结构调整路径。

2. 修正VS Code的tasks.json配置 #

如果用VS Code的“编译活动文件”功能，打开.vscode/tasks.json，确保编译参数完整：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "g++.exe build active file",
            "type": "shell",
            "command": "g++",
            "args": [
                "${file}",
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe",
                "-I", "${workspaceFolder}\\Include",
                "-L", "${workspaceFolder}\\Lib",
                "-lSDL2main",
                "-lSDL2"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": ["$gcc"]
        }
    ]
}

注意替换Include和Lib为你实际的目录名称。

3. 检查SDL2库的兼容性 #

• 确认下载的SDL2库与你的编译器位数（32/64位）、系统平台完全匹配，比如64位g++不能搭配32位SDL2库。
• Windows平台需将SDL2.dll放到可执行文件同目录，或者加入系统环境变量路径，否则即使编译通过，运行时也会出错。

4. 手动执行编译命令排查细节 #

直接在终端里运行编译命令，不要依赖VS Code的预启动任务，这样能看到完整的错误输出，比如找不到库文件、链接符号缺失等，这些信息在VS Code的任务面板中可能被隐藏。

用户提供的测试代码：

#include <iostream>
#include <SDL2/SDL.h>

const int WIDTH = 800, HEIGHT = 600;

int main(int argc, char *argv[] )
{
    SDL_Init(SDL_INIT_EVERYTHING);

    SDL_Window *window = SDL_CreateWindow("Hello World!", SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, WIDTH, HEIGHT, SDL_WINDOW_ALLOW_HIGHDPI);

    if(NULL == window)
    {
        std::cout << "Could not create window" << SDL_GetError() << std::endl;
        return 1;
    }

    SDL_Event windowEvent;

    while(true)
    {
        if(SDL_PollEvent(&windowEvent))
        {
            if(SDL_QUIT == windowEvent.type)
            {
                break;
            }
        }
    }

    SDL_DestroyWindow(window);
    SDL_Quit();

    return EXIT_SUCCESS;
}

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