使用Raylib编译基础C++游戏程序时出现未定义引用错误

你的错误是链接器阶段的问题：编译器能成功找到raylib.h头文件（所以没有语法或头文件找不到的错误），但链接器无法找到Raylib库中函数的实现代码（比如InitWindow、DrawCircle这些函数的二进制实现）。下面是具体的解决步骤：

1. 手动编译时添加链接参数 #

如果你用MSYS2的g++命令行编译，必须在编译命令末尾加上Raylib库和它依赖的系统库参数：

g++ main.cpp -o bouncing_ball.exe -lraylib -lopengl32 -lgdi32 -lwinmm

• -lraylib：指定链接Raylib库
• -lopengl32 -lgdi32 -lwinmm：这些是Raylib在Windows/mingw环境下依赖的系统库，缺一不可。

2. IDE环境下的设置调整 #

如果你用VSCode、Code::Blocks等IDE，需要在项目的链接器设置中添加这些参数：

• VSCode：打开.vscode/tasks.json，在编译任务的args数组中加入：

  "-lraylib", "-lopengl32", "-lgdi32", "-lwinmm"
  

• Code::Blocks：依次点击「项目」→「构建选项」→「链接器设置」，在「其他链接器选项」中填入上述参数，或者在「链接库」列表中添加raylib、opengl32、gdi32、winmm。

3. 验证Raylib安装正确性 #

确保你安装的Raylib和编译器架构匹配：

• 如果你用MSYS2的mingw64（64位），必须安装64位版本的Raylib：

  pacman -S mingw-w64-x86_64-raylib
  

• 不要手动修改头文件路径，包管理器安装的Raylib会自动被编译器识别，手动修改反而可能导致路径不匹配。

附你的代码（方便参考）：

#include <iostream>
#include <raylib.h>

using namespace std;

int main () {

    const int SCREEN_WIDTH = 800;
    const int SCREEN_HEIGHT = 600;
    int ball_x = 100;
    int ball_y = 100;
    int ball_speed_x = 5;
    int ball_speed_y = 5;
    int ball_radius = 15;

    cout << "Hello World" << endl;

    InitWindow(SCREEN_WIDTH, SCREEN_HEIGHT, "My first RAYLIB program!");
    SetTargetFPS(60);

    while (WindowShouldClose() == false){
   
        ball_x += ball_speed_x;
        ball_y += ball_speed_y;

        if(ball_x + ball_radius >= SCREEN_WIDTH || ball_x - ball_radius <= 0)
        {
            ball_speed_x *= -1;
        }

        if(ball_y + ball_radius >= SCREEN_HEIGHT || ball_y - ball_radius <= 0)
        {
            ball_speed_y *= -1;
        }
        
        BeginDrawing();
            ClearBackground(BLACK);
            DrawCircle(ball_x,ball_y,ball_radius, WHITE);
        EndDrawing();
    }

    CloseWindow();
}

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