SDL_Init(SDL_INIT_VIDEO)返回-1时，应立即调用SDL_GetError()获取具体错误字符串，如“Could not initialize SDL”“No available video device”等，以定位初始化失败原因。
SDL2初始化失败：SDL_Init(SDL_INIT_VIDEO) 返回 -1 怎么查
多数新手卡在第一步——连窗口都开不出来。先确认 SDL_Init() 是否真的失败：SDL_GetError() 会返回具体原因，比如 "Could not initialize SDL: No available video device"，这通常意味着没正确链接原生图形后端（Linux 缺 libx11-dev，macOS 没装 XQuartz 或用错了 SDK，Windows 则可能是 DLL 路径不对）。
实操建议：
- Linux 下确保已安装
libx11-dev和libgl1-mesa-dev；编译时加-lSDL2 -lSDL2main - macOS 上优先用 Homebrew 安装
sdl2，避免手动拖 framework；Xcode 中需在Build Settings → Other Linker Flags加-framework SDL2 - Windows 用户别直接复制
SDL2.dll到系统目录，应放在可执行文件同级目录，或用SetDllDirectory()显式指定路径
创建窗口后黑屏/闪退：SDL_CreateWindow 成功但没渲染
窗口创建成功不等于能画东西。SDL 的渲染流程是显式双缓冲：必须调用 SDL_CreateRenderer() 获取渲染器，再用 SDL_SetRenderDrawColor() + SDL_RenderClear() 清屏，最后 SDL_RenderPresent() 提交帧。漏掉任意一步都会导致黑屏或旧画面残留。
常见错误现象：
- 窗口一闪而逝 → 忘了主循环，或循环里没调
SDL_PollEvent()处理SDL_QUIT - 窗口一直黑 → 没调
SDL_RenderClear()或清屏颜色设成了黑色且没画任何东西 - 画面撕裂 → 没启用垂直同步，在
SDL_CreateRenderer()第三个参数传SDL_RENDERER_PRESENTVSYNC
最小可运行片段关键行：
auto win = SDL_CreateWindow("", 0, 0, 800, 600, SDL_WINDOW_SHOWN);
auto ren = SDL_CreateRenderer(win, -1, SDL_RENDERER_ACCELERATED | SDL_RENDERER_PRESENTVSYNC);
SDL_SetRenderDrawColor(ren, 30, 30, 30, 255);
SDL_RenderClear(ren);
SDL_RenderPresent(ren); // 这句不能少
图像加载失败：用 IMG_Load() 返回空指针
SDL_image 是独立库，不是 SDL2 自带的。即使头文件包含 SDL_image.h，若没链接 libSDL2_image 或没调 IMG_Init()，IMG_Load() 必然返回 nullptr，且 IMG_GetError() 才会给出真正原因（如 "Unsupported image format"）。
使用场景与参数差异：
- 支持格式依赖编译时开启的解码器：默认只开 PNG/JPG，若要 WebP 需链接
libwebp并传IMG_INIT_WEBP给IMG_Init() - 路径问题最常被忽略：Windows 下反斜杠要转义或用正斜杠；资源路径相对的是**可执行文件所在目录**，不是源码目录
- 加载后必须转成纹理：
SDL_CreateTextureFromSurface()，否则无法用SDL_RenderCopy()渲染
事件循环卡死或响应迟钝：SDL_PollEvent() 怎么写才稳
很多初学者把 SDL_PollEvent() 放错位置，比如放在渲染之后、或只调一次就跳出循环。它必须在每帧主循环内持续调用，直到返回 0（表示事件队列空），否则按键/鼠标事件会堆积或丢失。
性能与兼容性影响：
- 不要用
SDL_WaitEvent()替代 —— 它会阻塞线程，导致动画停顿、音频断续 - 处理
SDL_KEYDOWN时注意：长按会连续触发，如需“按下一次只生效一次”，得自己记录上一帧状态做边沿检测 - macOS 上某些键盘事件（如 Cmd+Q）需在
SDL_SetHint(SDL_HINT_MAC_CTRL_CLICK_EMULATE_RIGHT_CLICK, "1")后才能正常捕获右键
容易被忽略的细节：游戏逻辑更新频率和渲染帧率最好解耦。纯靠 SDL_PollEvent() 不足以支撑稳定物理模拟，真要做时间步进得用 SDL_GetTicks64() 计算 delta time。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
