本页目录

官方资料整理 Windows Linux macOS

SDL 开发与测试环境部署

配置 SDL2/SDL3 开发库与 C/C++ 工具链，编译窗口示例并迁移到现有开源项目的构建方式。

适用项目： 引擎通用（暂未关联具体项目）

工具版本：SDL2 或 SDL3、CMake、MSVC / MinGW / Clang

未标注「站长实测」的步骤请自行核验。

本篇为 SDL 通用环境教程。多数开源游戏仍使用 SDL2；新项目可能用 SDL3。请先看仓库的 README / CMakeLists.txt 再选版本。文档入口：SDL wiki。

1. 安装 SDL 开发包

Windows：从 GitHub Releases 下载 development 库，或用 vcpkg：vcpkg install sdl2。
Linux：如 libsdl2-dev（Debian/Ubuntu）或发行版等价包；需要图像/混音时再装 libsdl2-image-dev、libsdl2-mixer-dev、libsdl2-ttf-dev。
macOS：brew install sdl2（及 image/mixer/ttf 视项目而定）。

2. 最小窗口程序验证

用官方 Quickstart 思路写一个创建窗口再销毁的程序，或编译仓库自带的 test/examples。能出现空白窗口即说明头文件、库文件与运行时 DLL（Windows）路径正确。

Windows 注意：运行目录需能找到 SDL2.dll（或构建时静态链接）。

3. 接入现有开源项目

优先使用项目提供的 CMake preset / meson / xmake / Visual Studio 解决方案。
若 CMake 报 Could NOT find SDL2：设置 SDL2_DIR 或 CMAKE_PREFIX_PATH 指向 SDL 的 cmake 配置目录。
扩展库版本必须与主 SDL 大版本一致（不要混用 SDL2 与 SDL3 的附属库）。