M1芯片Ventura系统下SDL2仅弹出任务栏图标无法显示窗口

问题描述 #

在M1芯片的Mac上配置SDL2后，头文件可正常检测，但编译运行代码时，本该显示的全红窗口仅在任务栏出现一个无法点击的弹窗，此前使用pygame时也遇到类似问题。

代码问题修正 #

你的代码存在几个关键问题，导致窗口异常：

1. 重复调用SDL_Init：第一次调用后未检查返回值，第二次调用会直接失败，影响后续初始化流程
2. Metal后端Hint设置时机错误：需在SDL_Init之前设置，否则无法生效
3. 未检查窗口/渲染器创建结果：创建失败后继续操作会导致空指针异常

修正后的代码：

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

int main(int argc, char* args[])
{
    SDL_Window* window = nullptr;
    SDL_Renderer* renderer = nullptr;

    // 先设置Metal后端Hint，再初始化SDL
    SDL_SetHint(SDL_HINT_RENDER_DRIVER, "metal");
    
    // 初始化SDL并检查结果
    if (SDL_Init(SDL_INIT_EVERYTHING) != 0)
    {
        printf("SDL初始化失败！SDL_Error: %s\n", SDL_GetError());
        return -1;
    }

    // 创建窗口和渲染器并检查结果
    if (SDL_CreateWindowAndRenderer(640, 480, SDL_WINDOW_RESIZABLE, &window, &renderer) != 0)
    {
        printf("窗口/渲染器创建失败！SDL_Error: %s\n", SDL_GetError());
        SDL_Quit();
        return -1;
    }

    // 设置渲染颜色为红色
    SDL_SetRenderDrawColor(renderer, 255, 0, 0, 255);
    // 清空渲染器（填充红色）
    SDL_RenderClear(renderer);
    // 将渲染内容显示到窗口
    SDL_RenderPresent(renderer);

    // 等待3秒后退出
    SDL_Delay(3000);

    // 清理SDL资源
    SDL_DestroyRenderer(renderer);
    SDL_DestroyWindow(window);
    SDL_Quit();

    return 0;
}

CMake配置优化 #

不要硬编码SDL2的路径，改用find_package自动适配M1的Homebrew环境，同时指定架构避免兼容性问题：

cmake_minimum_required(VERSION 3.23)
project(SDLTest)

set(CMAKE_CXX_STANDARD 23)
# 指定M1芯片的arm64架构
set(CMAKE_OSX_ARCHITECTURES arm64)

# 自动查找SDL2包
find_package(SDL2 REQUIRED)

add_executable(SDLTest main.cpp)
# 链接SDL2的头文件和库
target_include_directories(SDLTest PRIVATE ${SDL2_INCLUDE_DIRS})
target_link_libraries(SDLTest PRIVATE ${SDL2_LIBRARIES})

额外注意事项 #

• 确保通过Homebrew安装的SDL2是arm64架构：执行brew install sdl2即可，M1上Homebrew默认安装到/opt/homebrew，自动适配芯片架构
• 如果指定Metal后端仍有问题，可尝试移除SDL_SetHint(SDL_HINT_RENDER_DRIVER, "metal")，让SDL自动选择合适的渲染驱动（如OpenGL）
• 验证编译后的程序架构：执行lipo -info SDLTest，确认输出为Non-fat file: SDLTest is architecture: arm64，避免x86_64架构的兼容性问题

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