SDL2加载图片无法显示到屏幕求助：程序无窗口弹出

尝试用SDL2将图片显示到屏幕但一直失败，filename指向的图片确实存在。查阅大量资料并借助GPT辅助，自认为操作无误，也试过其他教程的方法，但都没用。编译命令：

g++ Main.cpp -orun -lSDL2 -lSDL2_image -lGL -I/usr/local/include/SDL2

补充信息 #

• 系统：System76的Pop!_OS 22.04 LTS
• 代码已移至main()函数中
• 运行程序时无任何视觉反馈，仅while循环中的std::cout << "here\n";能正常输出，无编译及运行错误
• 测试最简SDL2窗口程序（代码如下），用相同命令编译后仍无法弹出窗口，无任何错误提示。已确认SDL2的头文件和库文件均已安装，但不知问题所在。

最简测试代码 #

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

int main(int argc, char* argv[]){  
    SDL_Window *window;  
    SDL_Init(SDL_INIT_VIDEO);  
    window = SDL_CreateWindow(
        "Test",
        SDL_WINDOWPOS_UNDEFINED,
        SDL_WINDOWPOS_UNDEFINED,
        640,
        480,
        SDL_WINDOW_OPENGL
    );  
    if(window == NULL){
        printf("Fail: %s\n", SDL_GetError());
        return 1;
    }  
    SDL_Delay(3000);  
    SDL_DestroyWindow(window);  
    SDL_Quit();  
    return 0;
}

图片显示代码 #

int main(){
    // Initialize SDL
    if (SDL_Init(SDL_INIT_VIDEO) != 0) {
        std::cout << "Failed to initialize SDL: " << SDL_GetError() << std::endl;
        return 1;
    }
    // Initialize SDL_image
    int imgFlags = IMG_INIT_PNG;
    if ((IMG_Init(imgFlags) & imgFlags) != imgFlags) {
        std::cout << "Failed to initialize SDL_image: " << IMG_GetError() << std::endl;
        SDL_Quit();
        return 1;
    }
    SDL_Surface* image_surface = IMG_Load(filename);
    if (image_surface == nullptr) {
        std::cout << "Failed to load image: " << IMG_GetError() << std::endl;
        IMG_Quit();
        SDL_Quit();
        return 1;
    }

    // Create an SDL window
    SDL_Window* window = SDL_CreateWindow(
        "Image Viewer",
        SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED,
        image_surface->w, image_surface->h,
        SDL_WINDOW_SHOWN | SDL_WINDOW_KEYBOARD_GRABBED
    );
    if (window == nullptr) {
        std::cout << "Failed to create SDL window: " << SDL_GetError() << std::endl;
        SDL_FreeSurface(image_surface);
        IMG_Quit();
        SDL_Quit();
        return 1;
    }

    // Create a renderer
    SDL_Renderer* renderer = SDL_CreateRenderer(window, -1, SDL_RENDERER_ACCELERATED);
    if (renderer == nullptr) {
        std::cout << "Failed to create SDL renderer: " << SDL_GetError() << std::endl;
        SDL_DestroyWindow(window);
        SDL_FreeSurface(image_surface);
        IMG_Quit();
        SDL_Quit();
        return 1;
    }
    // Create a texture from the surface
    SDL_Texture* texture = SDL_CreateTextureFromSurface(renderer, image_surface);
    if (texture == nullptr) {
        std::cout << "Failed to create SDL texture: " << SDL_GetError() << std::endl;
        SDL_DestroyRenderer(renderer);
        SDL_DestroyWindow(window);
        SDL_FreeSurface(image_surface);
        IMG_Quit();
        SDL_Quit();
        return 1;
    }
    // Wait for a key press to exit
    bool quit = false;
    SDL_Event event;
    // SDL_UpdateWindowSurface(window);
    while (!quit) {
        SDL_RenderClear(renderer);                          // Clear the renderer
        SDL_RenderCopy(renderer, texture, nullptr, nullptr);// Copy the texture to the renderer
        SDL_RenderPresent(renderer);                        // Update the renderer
        // SDL_UpdateWindowSurface(window);
        while (SDL_PollEvent(&event)) {
            if (event.type == SDL_QUIT || event.type == SDL_KEYDOWN) {
                quit = true;
            }
        }
        std::cout << "here\n";
    }
    // Cleanup
    SDL_DestroyTexture(texture);
    SDL_DestroyRenderer(renderer);
    SDL_DestroyWindow(window);
    SDL_FreeSurface(image_surface);
    IMG_Quit();
    SDL_Quit();
    return 0;
}

核心问题是最简SDL窗口都无法弹出，说明不是图片加载或渲染逻辑的问题，而是SDL在Pop!_OS下的显示环境配置问题，以下是具体排查和解决方向：

1. 强制指定SDL视频驱动 #

Pop!_OS默认使用Wayland，SDL2可能未自动适配。运行程序时强制指定X11驱动测试：

SDL_VIDEODRIVER=x11 ./run

如果能弹出窗口，可通过以下方式永久设置：

• Bash用户：echo "export SDL_VIDEODRIVER=x11" >> ~/.bashrc
• Zsh用户：echo "export SDL_VIDEODRIVER=x11" >> ~/.zshrc
  设置后重启终端生效。

2. 调整编译参数与窗口创建标志 #

你的编译命令中加入了-lGL，但最简测试代码启用了SDL_WINDOW_OPENGL，可能导致OpenGL上下文初始化异常。尝试：

• 去掉-lGL参数，或改用SDL默认窗口标志：

window = SDL_CreateWindow(
    "Test",
    SDL_WINDOWPOS_UNDEFINED,
    SDL_WINDOWPOS_UNDEFINED,
    640,
    480,
    SDL_WINDOW_SHOWN  // 替换SDL_WINDOW_OPENGL
);

重新编译运行。

3. 用官方工具生成正确编译参数 #

手动指定路径可能出错，用sdl2-config自动获取编译参数：

g++ Main.cpp -orun $(sdl2-config --cflags --libs) -lSDL2_image

若提示sdl2-config未找到，先重新安装完整依赖：

sudo apt update
sudo apt install libsdl2-dev libsdl2-image-dev

4. 切换X11会话测试 #

Wayland对部分程序兼容性较差，登录系统时选择"Pop!_OS on X11"而非默认的Wayland会话，再运行程序验证。

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