Mac环境下VSCode配置SDL2遇链接错误，求解决方案

在Mac系统的VSCode中配置SDL2开发环境时，运行main.cpp出现以下链接错误：

Undefined symbols for architecture x86_64:
  "_SDL_CreateWindow", referenced from:
      _main in main-9eb1c9.o
  "_SDL_DestroyWindow", referenced from:
      _main in main-9eb1c9.o
  "_SDL_Init", referenced from:
      _main in main-9eb1c9.o
  "_SDL_PollEvent", referenced from:
      _main in main-9eb1c9.o
  "_SDL_Quit", referenced from:
      _main in main-9eb1c9.o
ld: symbol(s) not found for architecture x86_64
clang: error: linker command failed with exit code 1 (use -v to see invocation)

当前使用的tasks.json内容：

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++ 建置使用中檔案",
            "command": "/usr/bin/g++",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "偵錯工具產生的工作。"
        }
    ],
    "version": "2.0.0"
}

main.cpp代码：

#include <SDL2/SDL.h>
#include <iostream>

int main() {
    // 初始化SDL
    SDL_Init(SDL_INIT_VIDEO);

    // 創建視窗
    SDL_Window* window = SDL_CreateWindow("SDL2 Window",
                                          SDL_WINDOWPOS_UNDEFINED,
                                          SDL_WINDOWPOS_UNDEFINED,
                                          800, 600,
                                          SDL_WINDOW_SHOWN);

    // 主迴圈
    SDL_Event event;
    bool quit = false;
    while (!quit) {
        while (SDL_PollEvent(&event)) {
            if (event.type == SDL_QUIT) {
                quit = true;
            }
        }
    }

    // 釋放資源
    SDL_DestroyWindow(window);
    SDL_Quit();

    return 0;
}

尝试过的Makefile内容（错误依旧）：

all:
    g++ -Iinclude -Llib/SDL2 -o main src/*.cpp -lSDL2main -lSDL2

解决步骤 #

1. 确认SDL2的安装方式

• 优先用Homebrew安装SDL2，执行命令：

  brew install sdl2
  

  安装后系统会自动配置头文件和库的路径，无需手动指定-I和-L参数。
• 如果是手动下载的SDL2包，要确认头文件（SDL2/目录）和库文件（libSDL2.dylib）的路径是否正确。

2. 修改VSCode的tasks.json

当前tasks.json的编译参数未链接SDL2库，需在args中添加-lSDL2参数。修改后的tasks.json如下：

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++ 建置使用中檔案",
            "command": "/usr/bin/g++",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}",
                "-lSDL2"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "偵錯工具產生的工作。"
        }
    ],
    "version": "2.0.0"
}

3. 修正Makefile

• 如果是Homebrew安装的SDL2，简化Makefile为：

  all:
      g++ -g src/*.cpp -o main -lSDL2
  

• 如果是手动安装的SDL2，需要指定正确的头文件和库路径，比如：

  all:
      g++ -I/你的SDL2头文件路径/include -L/你的SDL2库路径/lib -o main src/*.cpp -lSDL2
  

  注意：Mac平台无需链接-lSDL2main，该参数仅适用于Windows。

4. 验证编译运行

重新在VSCode中执行构建任务，或在终端执行make，生成可执行文件后运行，即可正常弹出SDL2窗口。

内容的提问来源于stack exchange，提问作者kiki