sdl_init 返回 -1 的主因是库未正确加载或子系统选择不当；务必检查返回值并用 sdl_geterror() 获取具体错误信息，优先确保 sdl2.dll 在运行目录或系统路径中。
SDL2 初始化失败：SDL_Init 返回 -1 怎么办
多数人卡在第一步，SDL_Init 直接返回 -1，窗口没影儿，连错误提示都看不到。根本原因不是代码写错，而是 SDL 库没正确加载或子系统选错了。
实操建议：
- 必须检查返回值：
if (SDL_Init(SDL_INIT_VIDEO) ，别只调用不判断 - 初始化时只开需要的子系统——游戏初期只要
SDL_INIT_VIDEO，加SDL_INIT_AUDIO或SDL_INIT_EVENTS可能触发额外依赖失败 - Windows 下缺
SDL2.dll是最常见原因，它得跟 exe 在同一目录，不能只靠 IDE 的运行路径设置 - macOS 上如果用 Homebrew 装的 SDL2，要确保链接的是动态库（
libSDL2.dylib），静态链接容易因 Metal 后端缺失报错
创建窗口黑屏或闪退：SDL_CreateWindow 返回 nullptr
窗口对象是空指针，后续所有渲染都会崩。这不是 SDL 版本问题，而是显卡驱动、显示模式或参数越界导致的静默失败。
实操建议：
- 传参别硬写数字：
SDL_CreateWindow("Game", SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, 800, 600, SDL_WINDOW_SHOWN)中的SDL_WINDOWPOS_UNDEFINED必须用，手写0会误判为坐标原点（可能被系统挡住） - 分辨率别瞎设：比如在 macOS Retina 屏上用
1920x1080没问题，但若传3840x2160又没启用高 DPI 支持，窗口可能创建成功却无法显示内容 - Linux Wayland 下默认不支持
SDL_WINDOW_OPENGL，加了这个 flag 就会返回 nullptr；改用 X11 后端或去掉该 flag - 检查
SDL_GetError()—— 它比断点更准，比如输出"Could not create window: Vulkan instance creation failed"就说明你误启了 Vulkan 后端
渲染器创建后 draw 不出东西：SDL_CreateRenderer 返回 nullptr 或画面全黑
窗口有了，渲染器却建不起来，或者建起来了但 SDL_RenderClear + SDL_RenderPresent 后屏幕还是黑的。本质是渲染后端和窗口不匹配。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
实操建议：
-
SDL_CreateRenderer第三个参数别写-1：它表示“自动选后端”，但在某些集成显卡或远程桌面环境下会 fallback 到无效驱动，明确写SDL_RENDERER_ACCELERATED更稳 - 必须确认窗口是
SDL_WINDOW_SHOWN状态再创建渲染器，否则部分平台（如 Windows GDI）会拒绝绑定 - 黑屏常见原因是忘记调用
SDL_RenderClear—— 它不是可选项，是清缓冲区的必要步骤；漏掉就等于拿脏内存当画布 - macOS 上如果用了
SDL_HINT_RENDER_DRIVER强制设为"opengl"，但系统禁用了 OpenGL（如 macOS 13+），渲染器就会创建失败，此时应删掉 hint 或改用"metal"
窗口关闭后程序卡住或崩溃：SDL_Quit 没救回来
关窗口后进程还在跑，或者直接 segfault。问题不在退出逻辑本身，而在资源释放顺序和线程安全边界上。
实操建议：
- 渲染器、窗口、纹理这些对象，必须在
SDL_Quit前手动销毁：SDL_DestroyRenderer→SDL_DestroyWindow→SDL_Quit，顺序反了在 Linux 上可能 hang 住 - 不要在事件循环外提前调
SDL_DestroyWindow：比如响应SDL_QUIT事件时只设标志位，等循环结束再销毁，否则SDL_PollEvent可能读到已释放窗口的残留事件 - 多线程下严禁从非主线程调
SDL_DestroyRenderer—— SDL2 渲染 API 不是线程安全的，哪怕只是读取SDL_RendererInfo - Windows 控制台程序中，如果用
system("pause")卡住进程再退出，SDL 的清理钩子可能来不及触发，导致下次启动时报 “Direct3D device lost” 类错误
SDL2 的窗口和渲染链路看着简单，但每个环节都绑着平台行为。最常被忽略的是：错误检查不能只靠 return value，还得配 SDL_GetError()；资源释放不能图省事堆在最后，得按依赖顺序一层层拆。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
