VS Code中Clang编译Raylib C代码出现未定义符号错误的解决方法

我是C语言新手，尝试用raylib创建窗口，编译器用clang，在Visual Studio Code中编译时持续出现错误。

我的代码：

#include "raylib.h"

int main(void)
{
    const int screenWidth = 800;
    const int screenHeight = 450;

    InitWindow(screenWidth, screenHeight, "raylib  example - basic window");

    SetTargetFPS(60);               
    
    // Main game loop
    while (!WindowShouldClose())    
    {
        BeginDrawing();
            ClearBackground(RAYWHITE);
            DrawText("Congrats! You created your first window!", 190, 200, 20, LIGHTGRAY);
        EndDrawing();
    }
    
    CloseWindow();        

    return 0;
} 

错误信息：

Undefined symbols for architecture x86_64:
  "_BeginDrawing", referenced from:
      _main in raytest-8c368e.o
  "_ClearBackground", referenced from:
      _main in raytest-8c368e.o
  "_CloseWindow", referenced from:
      _main in raytest-8c368e.o
  "_DrawText", referenced from:
      _main in raytest-8c368e.o
  "_EndDrawing", referenced from:
      _main in raytest-8c368e.o
  "_InitWindow", referenced from:
      _main in raytest-8c368e.o
  "_SetTargetFPS", referenced from:
      _main in raytest-8c368e.o
  "_WindowShouldClose", referenced from:
      _main in raytest-8c368e.o
ld: symbol(s) not found for architecture x86_64

解决方案 #

这个错误是链接器无法找到Raylib库中的函数实现导致的——你只编译了自己的源代码，没有将Raylib的库文件链接到可执行程序中。以下是具体解决步骤：

1. 配置VS Code的编译任务（tasks.json） #

打开VS Code的命令面板（Ctrl+Shift+P），输入Tasks: Configure Default Build Task，选择clang: build active file，然后修改生成的tasks.json文件，在编译参数中添加Raylib的链接选项：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "clang build raylib",
            "type": "shell",
            "command": "clang",
            "args": [
                "-o",
                "${fileBasenameNoExtension}",
                "${file}",
                "-lraylib",
                // macOS需要链接以下系统框架，Linux或Windows可根据情况删除
                "-framework", "OpenGL",
                "-framework", "Cocoa",
                "-framework", "IOKit",
                "-framework", "CoreAudio",
                "-framework", "CoreVideo"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": ["$gcc"]
        }
    ]
}

2. 关键参数说明 #

• -lraylib：告诉链接器要链接Raylib库
• 如果你的Raylib是手动编译安装到非默认路径（比如~/raylib/build），需要额外添加-L/your/raylib/library/path参数，指定库文件所在目录
• macOS系统必须链接OpenGL、Cocoa等框架，这是Raylib依赖的系统库

3. 验证编译 #

保存tasks.json后，回到代码文件，按Ctrl+Shift+B执行编译任务，即可生成可执行文件并正常运行。

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