SDL 2 開發環境完整搭建指南（Windows + Visual Studio）

為什麼選擇 SDL？

C 標準庫無圖形能力，SDL（Simple DirectMedia Layer）是輕量、跨平台、開源的多媒體庫，提供視頻、音頻、輸入事件、線程等子系統，適合入門遊戲開發、多媒體應用。相比 DirectX/OpenGL，API 簡潔，代碼量少 5-6 倍。

下載地址（官方發布頁）

• SDL 核心：https://www.libsdl.org/release/SDL-devel-1.2.14-VC8.zip
• 圖像擴展：https://www.libsdl.org/projects/SDL_image/release/SDL_image-devel-1.2.10-VC.zip
• 音頻擴展：https://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-devel-1.2.11-VC.zip

每個包含 include/（頭文件）與 lib/（.lib/.dll）。

兩種部署方式

方式一：複製到 VS 系統目錄（不推薦）

1. 解壓後，將 include/SDL/ 複製到 VC/include/SDL/。
2. lib/*.lib → VC/lib/；*.dll → C:\Windows\System32/。
3. 擴展包同理處理。

缺點：污染系統目錄，可能衝突其他專案。

方式二：專案級獨立目錄（推薦）

1. 建立專案專屬目錄 SDL/，下設 include/、lib/、dll/。
2. 將三個包的頭文件、.lib、.dll 分別放入對應子目錄。
3. VS 專案屬性配置：
   C/C++ → General → Additional Include Directories 加入 $(ProjectDir)SDL/include
   Linker → General → Additional Library Directories 加入 $(ProjectDir)SDL/lib
   Linker → Input → Additional Dependencies 加入 SDL.lib;SDLmain.lib;SDL_image.lib;SDL_mixer.lib
   C/C++ → Code Generation → Runtime Library 選 Multi-threaded DLL (/MD) 或一致的模式。
4. 運行時需將 dll/ 加入系統 PATH 或複製到輸出目錄。

驗證測試代碼

#include <stdio.h>
#include <stdlib.h>
#include <SDL/SDL.h>

int main(int argc, char* argv[]) {
    if (SDL_Init(SDL_INIT_VIDEO | SDL_INIT_AUDIO) == -1) return -1;
    SDL_Surface* screen = SDL_SetVideoMode(600, 600, 0,
        SDL_HWSURFACE | SDL_HWPALETTE | SDL_DOUBLEBUF);
    if (!screen) { SDL_Quit(); return -1; }
    SDL_Delay(3000);
    SDL_FreeSurface(screen);
    SDL_Quit();
    return 0;
}

注意：主函數必須為 int main(int argc, char* argv[])，頭文件引用 <SDL/SDL.h>。

常見坑點

• VS 必須安裝在純英文路徑，SDL 對中文路徑支持差。
• Debug/Release 配置需分別設置庫目錄與依賴項。
• 缺少 SDL.dll 運行時報錯，檢查 PATH 或輸出目錄。