SDL3初始化完整指南：从SDL2迁移到SDL3的C++实战解析

从SDL2迁到SDL3，第一步就把我整不会了。原本以为只是把头文件换成<SDL3/SDL.h>，再改改链接库，结果连编译都过不去。窗口创建空指针、主函数入口找不到、连SDL_QUIT这种从小就认识的老朋友都就地改名。折腾了几天，把官方迁移指南、源码和论坛帖子翻了个遍，才把“初始化”这关彻底啃下来。这篇文章就以C++为主线，把SDL3初始化的完整链路——从环境准备、库选择、窗口渲染器创建，到事件循环和错误排查——全部拆开讲透。刚上手SDL3，或者正打算迁移老项目的C++开发者，照着走一遍基本能少踩一半坑。

1. SDL3初始化到底改了什么

1.1 SDL3不是SDL2的“版本号+1”

很多人和我一样，一开始以为SDL3只是SDL2的例行更新，修修bug、加点接口，原来的代码顶多改两行就能跑。结果SDL3是一次彻头彻尾的API重构，命名规范、参数设计、事件体系全部推倒重来。在初始化这条路径上，有几个变化直接影响代码能不能编译、能不能跑起来。

首当其冲的是窗口创建函数。SDL2时代我们写SDL_CreateWindow(title, x, y, w, h, flags)，位置参数和尺寸参数一起传。SDL3里这个函数被拆成了两个方向：SDL_CreateWindow(title, w, h, flags)只负责按系统默认位置创建窗口；如果你想精确控制窗口出现在屏幕哪个位置，得用另一套SDL_CreateWindowWithPosition(title, x, y, w, h, flags)。这么设计的好处是，大部分桌面程序根本不关心窗口起始坐标，系统自己安排反而更合理；强行指定坐标容易出现在多显示器环境里跑到屏幕外的尴尬情况。

渲染器创建接口的变化更大。SDL2的SDL_CreateRenderer(window, index, flags)用整数索引选驱动，比如0代表默认、1代表OpenGL、2代表Direct3D，这种索引方式在不同平台上含义完全不同，可读性极差。SDL3直接把索引参数换成了字符串：SDL_CreateRenderer(window, name, flags)，name可以传"direct3d"、"opengl"、"software"，或者传nullptr让SDL自己选。迁移老代码的时候，如果你还按SDL2的方式传一个整数，编译器一定会给你好看。

事件常量也改头换面了。SDL_QUIT在SDL3里叫SDL_EVENT_QUIT，SDL_KEYDOWN变成SDL_EVENT_KEY_DOWN，SDL_MOUSEBUTTONDOWN变成SDL_EVENT_MOUSE_BUTTON_DOWN。新库还顺手把事件里的窗口指针换成了windowID，也就是窗口的编号，需要你自己调用SDL_GetWindowFromID去拿窗口对象。这个改动对单窗口应用影响不大，但对多窗口程序的初始化逻辑是颠覆性的。

下面这张表直观列出SDL2到SDL3的对应关系，迁移时可以先对一遍：

你不需要把SDL3所有变化一次学完，但初始化这条链路，上面几个必须记住。否则你连一个空窗口都弹不出来。

1.2 初始化前建议先备好这三样东西

开始写SDL3代码之前，建议把开发环境理顺。第一个是编译器，C++这边推荐支持C++17或以上的编译器，Windows用VS2022或MinGW-w64，Linux用GCC 9以上的版本，macOS用Clang。新版编译器对新库的兼容性更好，报错信息也更容易看懂。第二个是构建系统，我强烈建议用CMake，因为SDL3官方提供了一套完整的CMake配置文件，会自动导出SDL3::SDL3这个target，你不用手工去纠结头文件目录、链接库目录、依赖顺序这些问题。第三个是SDL3库本身，获取方式有几种：用vcpkg一条命令vcpkg install sdl3最省事；也可以从GitHub拉源码自己编译；Linux上部分发行版现在已经带了libsdl3-dev，但版本可能偏旧，如果你要用最新功能还是建议源码安装。

有Windows部署经验的朋友，建议顺便把“Microsoft Visual C++ Redistributable”装上。SDL3的预编译Windows版本依赖VC++运行库，缺了它运行时直接弹“找不到VCRUNTIME140.dll”之类的报错。我见过不少朋友卡在这一步，以为自己SDL3初始化代码写错了，其实是运行库缺失，完全两码事。

集成开发环境用VS Code完全够用，装好C/C++扩展和CMake Tools扩展就可以。Visual Studio用户更简单，直接用IDE的CMake支持打开项目即可。接下来我们进入正题，把初始化流程一步步拆开。

2. SDL3初始化核心流程拆解

2.1 从SDL_Init开始，先给整个库“通电”

SDL3初始化的第一步永远是SDL_Init，它的职责是加载SDL内部各个子系统。函数签名是int SDL_Init(Uint32 flags)，返回值0表示成功，非0表示失败。flags按位或组合，你可以选择只初始化真正用到的部分，常见的有SDL_INIT_VIDEO（视频）、SDL_INIT_AUDIO（音频）、SDL_INIT_TIMER（定时器）、SDL_INIT_GAMEPAD（手柄）、SDL_INIT_JOYSTICK（摇杆）、SDL_INIT_HAPTIC（力反馈）、SDL_INIT_SENSOR（传感器）、SDL_INIT_CAMERA（摄像头）等。

处理图形窗口的应用，通常只需要SDL_INIT_VIDEO。很多初学者喜欢一股脑SDL_Init(SDL_INIT_EVERYTHING)，这在SDL2时代勉强能用，但SDL3里我强烈不建议这么做。每多初始化一个子系统，就多一分启动失败的风险。比如你只是写个图像查看器，结果去初始化手柄和摄像头，在部分机器上可能直接失败，连窗口都弹不出来。按需初始化的另一个好处是启动速度更快，错误定位也更清晰。

如果你后面又需要音频，不必重启全库，用SDL_InitSubSystem单独补一个子系统：

cpp复制// 先只初始化视频
if (SDL_Init(SDL_INIT_VIDEO) != 0) {
    SDL_Log("SDL_Init failed: %s", SDL_GetError());
    return -1;
}

// 某天需要音频了，动态补上
if (SDL_InitSubSystem(SDL_INIT_AUDIO) != 0) {
    SDL_Log("SDL_InitSubSystem(audio) failed: %s", SDL_GetError());
}

对应的退出逻辑也有讲究。不需要某个子系统时，可以用SDL_QuitSubSystem单独关闭它；程序结束前再统一SDL_Quit()做全量清理。这种分层初始化的思路，能让整个应用的生命周期管理更清晰。

关键时刻别忘了SDL_GetError()，它返回一个const char*的错误描述字符串。几乎所有SDL3函数在失败后都会往这个错误缓冲区写一条信息，调出日志一看，问题基本能猜到大半。

2.2 创建窗口：SDL_CreateWindow还是SDL_CreateWindowWithPosition

SDL_Init成功之后，下一步就是创建窗口。SDL3里最常用的写法是：

cpp复制SDL_Window* window = SDL_CreateWindow("SDL3 Initialization Demo", 1280, 720, SDL_WINDOW_RESIZABLE);
if (!window) {
    SDL_Log("CreateWindow failed: %s", SDL_GetError());
    return -1;
}

注意SDL_CreateWindow的第二个和第三个参数是宽和高，不再有x和y。位置完全交给系统决定。如果你想自己控制窗口出现在屏幕的哪个角落，就用SDL_CreateWindowWithPosition：

cpp复制SDL_Window* window = SDL_CreateWindowWithPosition(
    "SDL3 Initialization Demo", 100, 100, 1280, 720, SDL_WINDOW_RESIZABLE);

这个API的设计意图很清晰：开发90%的应用都不需要指定位置，系统帮你摆可能更合理；剩下10%需要精准位置的场景（比如保存了用户上次的窗口坐标再恢复），单独提供一个接口，而不是让所有调用者都为那个用不到的参数买单。

SDL_CreateWindow的最后一个参数是窗口flags，几个常用的组合：

• SDL_WINDOW_RESIZABLE：允许用户拖拽调整窗口大小
• SDL_WINDOW_HIGH_PIXEL_DENSITY：在高分屏上启用高DPI支持，渲染清晰度会好很多
• SDL_WINDOW_FULLSCREEN：全屏模式
• SDL_WINDOW_BORDERLESS：无边框窗口
• SDL_WINDOW_OPENGL / SDL_WINDOW_VULKAN：配合特定图形API使用

这里有个细节要注意：SDL3默认创建的窗口就是“显示”状态，不需要像某些框架那样创建后再调用show函数。如果程序运行起来黑屏没窗口，先说清楚是否在窗口创建后手动调用了SDL_HideWindow，或者上一段逻辑把窗口隐藏了，这种低级问题特别容易排在“奇怪”的问题里。

2.3 渲染器初始化：从索引到名字的参数革命

窗口创建好以后，通常要接着创建渲染器。SDL_Renderer是SDL统一的2D绘制接口，CPU绘制和GPU绘制都在它后面帮你封装好，你不用关心不同显卡驱动之间的差异。

cpp复制SDL_Renderer* renderer = SDL_CreateRenderer(window, nullptr,
    SDL_RENDERER_ACCELERATED | SDL_RENDERER_PRESENTVSYNC);
if (!renderer) {
    SDL_Log("CreateRenderer failed: %s", SDL_GetError());
    return -1;
}

第二个参数传nullptr，意味着让SDL自动选择最合适的驱动程序。如果你明确知道目标平台，也可以传入"direct3d"（Windows）、"opengl"（跨平台）、"metal"（macOS）、"software"（软渲染兜底）。第三个参数是渲染器flags，常见的组合是SDL_RENDERER_ACCELERATED | SDL_RENDERER_PRESENTVSYNC，前者请求硬件加速，后者开启垂直同步，防止画面撕裂。开启垂直同步也会让渲染帧率跟着显示器刷新率走，比如60Hz的显示器就锁在60 FPS。

这里想说一下为什么SDL3要把SDL2的整数索引改成字符串名字。SDL2时代，SDL_CreateRenderer(window, -1, flags)是默认驱动，0是第一个驱动，1是第二个，但排在前面的到底是Direct3D还是OpenGL，不同平台顺序完全不一样。你在Windows上用的好好的索引1，换到Linux上可能变成软件渲染，性能一落千丈。用字符串名字直接指定或交给SDL自动选择，消除了这种不确定性。

如果硬件加速渲染器创建失败，一个常见的回退策略是改用软件渲染：

cpp复制// 先试硬件加速
SDL_Renderer* renderer = SDL_CreateRenderer(window, nullptr, SDL_RENDERER_ACCELERATED);
if (!renderer) {
    SDL_Log("Hardware renderer failed, fallback to software: %s", SDL_GetError());
    renderer = SDL_CreateRenderer(window, "software", 0);
}

“software”是SDL内置的软件渲染驱动，不依赖显卡，几乎在任何平台上都能创建成功。虽然性能不如GPU加速，但至少能让程序先跑起来，适合调试和兜底。

2.4 主循环与退出：初始化之后立刻绷紧的弦

窗口和渲染器都创建成功，下一步就是事件循环。初始化做得再好，如果循环写错，窗口也会瞬间关闭或卡死。一个最精简的SDL3主循环长这样：

cpp复制bool running = true;
SDL_Event event;

while (running) {
    while (SDL_PollEvent(&event)) {
        if (event.type == SDL_EVENT_QUIT) {
            running = false;
        }
        if (event.type == SDL_EVENT_KEY_DOWN) {
            if (event.key.key == SDLK_ESCAPE) {
                running = false;
            }
        }
    }

    SDL_SetRenderDrawColor(renderer, 30, 30, 40, 255);
    SDL_RenderClear(renderer);
    // 这里可以画各种内容

    SDL_RenderPresent(renderer);
}

SDL_PollEvent从事件队列里取出一条事件，有事件就返回1，没事件返回0。内层while循环把所有积压的事件处理完，再进入渲染逻辑。很多人在这里写if (SDL_PollEvent(&event))而不是while，会导致事件越积越多，窗口关闭响应迟钝，这都是细节问题。

退出清理的顺序，我建议固定成“后创建的先销毁”：先SDL_DestroyRenderer(renderer)，再SDL_DestroyWindow(window)，最后SDL_Quit()。顺序反了可能出现明明窗口关了，进程却还挂在后台的情况，这种问题排查起来也浪费不少时间。

3. 手把手跑通一个SDL3初始化工程

3.1 最小可编译代码：一个真正能跑的窗口

不整花活，直接给一个完整、带错误处理的SDL3初始化示例。这个程序会创建一个1280x720的可调整大小窗口，背景用深灰色，按下ESC或点窗口关闭按钮退出。

cpp复制#include <SDL3/SDL.h>
#include <cstdio>

int main(int argc, char* argv[]) {
    // 初始化视频子系统
    if (SDL_Init(SDL_INIT_VIDEO) != 0) {
        SDL_Log("SDL_Init failed: %s", SDL_GetError());
        return -1;
    }

    // 创建窗口
    SDL_Window* window = SDL_CreateWindow(
        "SDL3 Initialization Demo",
        1280, 720,
        SDL_WINDOW_RESIZABLE | SDL_WINDOW_HIGH_PIXEL_DENSITY);
    if (!window) {
        SDL_Log("SDL_CreateWindow failed: %s", SDL_GetError());
        SDL_Quit();
        return -1;
    }

    // 创建渲染器
    SDL_Renderer* renderer = SDL_CreateRenderer(window, nullptr,
        SDL_RENDERER_ACCELERATED | SDL_RENDERER_PRESENTVSYNC);
    if (!renderer) {
        SDL_Log("SDL_CreateRenderer failed: %s", SDL_GetError());
        SDL_DestroyWindow(window);
        SDL_Quit();
        return -1;
    }

    // 主事件循环
    bool running = true;
    SDL_Event event;
    while (running) {
        while (SDL_PollEvent(&event)) {
            if (event.type == SDL_EVENT_QUIT) {
                running = false;
            } else if (event.type == SDL_EVENT_KEY_DOWN) {
                if (event.key.key == SDLK_ESCAPE) {
                    running = false;
                }
            }
        }

        // 清屏并渲染
        SDL_SetRenderDrawColor(renderer, 30, 30, 40, 255);
        SDL_RenderClear(renderer);
        SDL_RenderPresent(renderer);
    }

    // 清理资源
    SDL_DestroyRenderer(renderer);
    SDL_DestroyWindow(window);
    SDL_Quit();
    return 0;
}

这段代码有几个容易被忽略的设计点。第一，每一步失败后不仅要记录日志，还要把已经创建成功的资源释放掉，比如渲染器创建失败时，窗口已经在内存里了，不销毁它会造成资源泄漏。第二，main函数的argc和argv参数保留，因为SDL需要在某些平台接管入口，这个签名不能随便改成int main()，否则Windows上编译会出奇怪问题。

3.2 CMake构建配置：别再手动指定头文件目录了

配套的CMakeLists.txt非常简单：

cmake复制cmake_minimum_required(VERSION 3.16)
project(sdl3_hello LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(SDL3 CONFIG REQUIRED)

add_executable(sdl3_hello main.cpp)
target_link_libraries(sdl3_hello PRIVATE SDL3::SDL3)

find_package(SDL3 CONFIG REQUIRED)会去标准路径搜索SDL3安装目录，找到后会自动把头文件目录、链接库目录、依赖项都配置好，链接时只需要SDL3::SDL3这一个target。这条命令也会帮你处理平台相关的依赖，Windows上是SDL3.lib和SDL3.dll，Linux上是动态库加各种X11/Wayland依赖。

如果你用vcpkg安装的SDL3，CMake配置时要指定工具链文件：

bash复制cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE=[vcpkg根目录]/scripts/buildsystems/vcpkg.cmake
cmake --build build

编译生成的的可执行文件，Windows下记得把SDL3.dll复制到exe同目录，否则运行时会直接报“找不到SDL3.dll”。Linux下直接用系统包管理器安装库的话，一般不会有这个问题，但如果是自己编译的库，可能需要设置LD_LIBRARY_PATH。

这里插一句Windows链接的坑：SDL3官方提供的SDL3::SDL3 target在部分版本里不一定包含入口点处理库（就是负责把WinMain替换成main的那个小库）。如果你编译通过、链接时报“无法解析的外部符号 main”或者“WinMain”找不到，可以试试把SDL3::SDL3main也加进链接列表：

cmake复制target_link_libraries(sdl3_hello PRIVATE SDL3::SDL3 SDL3::SDL3main)

如果CMake找不到这个target，就搜一下SDL3安装目录下有没有SDL3main相关的库文件，手动链接也是可行的方案。

3.3 学会读SDL的日志，别瞎猜

SDL3的SDL_GetError()是你初始化阶段最好的朋友，但它有个特性要注意：返回的只是最后一次设置错误的字符串，而且很多函数调用后如果没有触发错误，会保留之前已经存在的错误信息。所以排查问题时，最好在每次SDK函数调用后立即判断并打印错误，不要攒到最后一次性处理。

上面示例里我用的是SDL_Log，这是SDL自己的日志宏，在Windows终端和Linux终端都能输出，比printf更省心。如果你发现VS Code集成终端里看不到输出，检查一下.vscode/tasks.json的console配置，改成"externalTerminal"或直接用系统终端跑程序。这种“日志没输出”的问题，跟初始化代码本身没关系，但会浪费你不少时间。

运行上面程序，顺利的话你会看到一个深灰色的窗口，按ESC退出。到了这一步，SDL3初始化的核心链路已经打通了。

4. 初始化阶段的常见错误与排查技巧

4.1 SDL_Init返回-1：先查驱动，再查依赖

SDL_Init失败是所有问题里最让人头疼的，因为它的失败原因和环境强相关。在Windows上，最常见的原因是显卡驱动太老或Direct3D运行时异常，SDL初始化视频子系统需要底层图形接口可用。在Linux上，常见的坑是X11或Wayland的开发库没装全，或者当前桌面会话的网络命名空间受限。macOS上通常是权限问题或者应用沙盒配置不对。

第一步永远是打印SDL_GetError()，根据文字提示缩小范围。如果只在虚拟机上跑，或者远程桌面环境，可以试试设置环境变量SDL_VIDEODRIVER=offscreen。这个驱动不弹窗口，专门用来做自动化测试和不需要真正显示的场景。它能帮你区分“SDL底层有问题”和“我的代码有问题”。不过这只是临时验证，真正交付的程序不能依赖offscreen。

还有一个思路是分步初始化，把SDL_Init(SDL_INIT_VIDEO | SDL_INIT_AUDIO)拆成两次，看是哪个子系统出的问题：

cpp复制if (SDL_Init(SDL_INIT_VIDEO) != 0) {
    SDL_Log("video init fail: %s", SDL_GetError());
}
if (SDL_InitSubSystem(SDL_INIT_AUDIO) != 0) {
    SDL_Log("audio init fail: %s", SDL_GetError());
}

这样一下就能定位到具体是哪个模块不兼容。

4.2 窗口创建成功，渲染器却是NULL

SDL_CreateRenderer返回NULL，多数情况是渲染驱动不满足flags要求。比如你要求硬件加速，但当前环境不支持；或者你传了一个不存在的渲染器名字。排查路径：

• 把SDL_CreateRenderer的第二个参数换成nullptr，让SDL自己去选，别手写死某个字符串。
• 把flags从SDL_RENDERER_ACCELERATED去掉。
• 直接指定软件渲染：SDL_CreateRenderer(window, "software", 0)。
• 打印SDL_GetError()，看提示里有没有具体驱动名称。

如果软件渲染能创建，说明窗口和库都没问题，纯粹是GPU加速路径不可用。这种情况在远程桌面、虚拟机、老显卡环境里很常见，不是你的代码错，而是宿主环境不支持。

4.3 事件没反应：SDL_EVENT_QUIT 和 SDL_PollEvent的双重陷阱

有些朋友代码运行起来窗口一直正常，但点关闭按钮没反应，只能用任务管理器杀进程。这种问题多半出在事件循环上。检查两点：第一，事件类型是不是写成了SDL2时代的SDL_QUIT，SDL3新代码里应该用SDL_EVENT_QUIT；第二，事件循环是不是用了if而不是while来轮询，导致事件积压，关闭事件永远排不到前面。

还有个隐蔽问题：窗口创建成功但程序启动后一直黑屏，检查SDL_PollEvent循环里是不是少写了SDL_RenderPresent(renderer)。这个调用负责把渲染结果提交到屏幕，漏掉的话，你看到的只是一个从未刷新过的窗口。

4.4 工程化：用智能指针接管SDL资源

SDL3是C接口，不认C++的RAII。如果你在函数中间某个初始化步骤失败了，前面已创建的资源要靠自己手动释放，写多了容易漏。在实际项目里，我会用模板函数把SDL资源包一层std::unique_ptr，让析构函数替我做清理：

cpp复制#include <memory>
#include <type_traits>

struct SDLDestroyer {
    void operator()(SDL_Window* p) const { if (p) SDL_DestroyWindow(p); }
    void operator()(SDL_Renderer* p) const { if (p) SDL_DestroyRenderer(p); }
};

using WindowPtr = std::unique_ptr<SDL_Window, SDLDestroyer>;
using RendererPtr = std::unique_ptr<SDL_Renderer, SDLDestroyer>;

这样创建和释放就变得很干净：

cpp复制WindowPtr window(SDL_CreateWindow("Demo", 1280, 720, SDL_WINDOW_RESIZABLE));
RendererPtr renderer(SDL_CreateRenderer(window.get(), nullptr, SDL_RENDERER_ACCELERATED));

后续不管是提前return还是抛出异常，资源都能自动释放。用起来一句话：初始化阶段可以把需要手动管理生命周期的东西尽量都交给RAII，后面写游戏逻辑时才能专注在功能上。

5. 进阶初始化：回调入口与多窗口

5.1 用SDL_Main回调模式替代传统main

SDL3新增了官方推荐的“回调式”入口，用SDL_AppInit、SDL_AppIterate、SDL_AppEvent、SDL_AppQuit一组函数构成应用生命周期。你的程序不再需要自己写main，SDL库会在合适时机调用这些回调。

使用方式是在包含SDL头文件之前定义宏：

cpp复制#define SDL_MAIN_USE_CALLBACKS
#include <SDL3/SDL.h>

然后实现这组函数，骨架长这样：

cpp复制SDL_AppResult SDL_AppInit(int argc, char* argv[]) {
    if (SDL_Init(SDL_INIT_VIDEO) != 0) {
        return SDL_APP_FAILURE;
    }
    // 创建窗口和渲染器
    return SDL_APP_CONTINUE;
}

bool SDL_AppEvent(const SDL_Event* event) {
    if (event->type == SDL_EVENT_QUIT) {
        return false;  // 返回 false 表示要退出
    }
    return true;
}

SDL_AppResult SDL_AppIterate() {
    // 每帧渲染逻辑
    return SDL_APP_CONTINUE;
}

void SDL_AppQuit(void* appstate, SDL_AppResult result) {
    // 清理资源
}

这种模式的好处是不用处理跨平台入口差异，框架已经帮你把Windows的WinMain、Linux的main、移动平台的入口都封装好了。如果你要开发游戏或实时渲染应用，建议早点习惯这套结构，它能让初始化代码和主循环逻辑更清晰。

5.2 给应用设置元数据：SDL_SetAppMetadata

SDL3.2之后提供了SDL_SetAppMetadata，用来设置应用名称、版本和标识符。这段信息在部分平台会显示在窗口标题、系统菜单或游戏平台（比如Steam）的元数据里。我习惯在SDL_Init之前先调：

cpp复制SDL_SetAppMetadata("My SDL3 App", "0.1.0", "com.example.mysdl3app");

第一个参数是应用显示名称，第二个是版本号，第三个是反向域名风格的唯一标识符。设置这一步虽然不影响窗口能否弹出来，但能避免在几个平台上出现“应用名称显示成可执行文件名”的尴尬。别小看这个细节，发布应用时会遇到不少平台要求填写应用标识，提前在初始化阶段埋好省得后面补。

5.3 多窗口初始化：用windowID而不是指针

SDL3把窗口事件从指针改成windowID，本质上是告诉开发者：别把一个SDL_Window*带出窗口生命周期之外，因为窗口可能随时被销毁重建，裸指针会悬空。初始化多个窗口时，正确的做法是保存ID，需要操作窗口时再通过SDL_GetWindowFromID找指针。

举个例子，初始化和处理两个窗口的事件：

cpp复制SDL_Window* win1 = SDL_CreateWindow("Window 1", 640, 480, 0);
SDL_Window* win2 = SDL_CreateWindow("Window 2", 640, 480, 0);
SDL_WindowID id1 = SDL_GetWindowID(win1);
SDL_WindowID id2 = SDL_GetWindowID(win2);

// 事件循环里
if (event.type == SDL_EVENT_WINDOW_CLOSE_REQUESTED) {
    if (event.window.windowID == id1) {
        // 处理主窗口关闭
    } else if (event.window.windowID == id2) {
        // 处理副窗口关闭
    }
}

这比直接比较指针更安全，因为事件系统拿到的是一个独立的ID，不依赖窗口对象是否还存活。多窗口App的初始化阶段，最好把窗口ID和业务对象绑定在一起管理，避免在事件处理里到处SDL_GetWindowFromID，代码会好维护很多。

6. 最后说点个人体会

SDL3这次初始化改动，本质上是一次从“能用就行”到“跨平台清晰”的进化。SDL2时期很多接口设计带着浓厚的桌面端历史包袱，很多参数在不同平台含义微妙地不一样，用多了全靠经验。SDL3用字符串替代索引、拆分窗口创建接口、事件统一加SDL_EVENT_前缀，都是在降低跨平台开发的认知成本。

我个人把SDL3初始化的步骤固化成了一套小模板：先SDL_SetAppMetadata，再SDL_Init，然后创建窗口和渲染器，中间每一处失败都立刻记录日志并释放已分配资源。平时调试用的软件渲染回退、RAII包装、事件循环里的ESC退出，都成了固定配置。新项目直接套模板，能少踩很多重复的坑。你也一样，别急着上游戏逻辑，先把初始化这条链路打磨顺，后面开发的体感会好很多。