Raylib C++打砖块游戏重启后小球异常移动问题排查

问题描述 #

用Raylib C++开发的打砖块游戏出现以下异常：

• 点击次数超过10次触发游戏结束后，点击退出按钮回到标题页
• 重启游戏时，小球会自动根据点击退出按钮的位置或最后一次点击的位置开始移动
• 这次自动移动不会计入点击次数

问题根源 #

1. 静态变量状态残留：ball.cpp的updateBall()里用了静态局部变量clicked，这个变量的状态会在游戏全程保留，游戏重启时不会自动重置为false，导致小球直接沿用之前的移动状态。
2. 未重置速度变量：游戏切换场景时只重置了小球位置，没重置ball_velocity速度向量，残留的速度数据会被带到新游戏中。
3. 状态控制不彻底：虽然在main.cpp里限制了updateBall()的调用条件，但clicked的静态状态没被清零，重启后依然生效。

修复步骤 #

1. 重构Ball类的状态变量 #

把updateBall()里的静态clicked变量改成Ball类的成员变量，方便外部重置状态：
修改ball.h：

class Ball {
public:
    // 现有成员函数...
    void resetBallState(); // 新增重置函数
    // ...
private:
    bool clicked = false; // 替换原静态局部变量
    Vector2 ball_position = {300, 750};
    Vector2 ball_velocity = {0, 0};
    Texture2D ball_texture;
    // ...其他私有成员...
};

2. 添加状态重置函数 #

在ball.cpp中实现resetBallState()，一次性重置所有相关状态：

void Ball::resetBallState()
{
    ball_position = {300, 750}; // 重置初始位置
    ball_velocity = {0, 0}; // 清零速度
    clicked = false; // 重置点击状态
}

3. 修改updateBall()函数 #

移除原静态变量声明，改用类成员变量：

void Ball::updateBall()
{
    // 删掉 static bool clicked = false; 这一行
 
    if (IsMouseButtonPressed(MOUSE_BUTTON_LEFT) && !clicked)
    {
        Vector2 cursorPos = GetMousePosition();
        clicked = true;

        ball_velocity.x = cursorPos.x - ball_position.x;
        ball_velocity.y = cursorPos.y - ball_position.y;

        float magnitude = sqrt(ball_velocity.x * ball_velocity.x + ball_velocity.y * ball_velocity.y);
        if (magnitude != 0) {
            ball_velocity.x /= magnitude;
            ball_velocity.y /= magnitude;
        }

        ball_velocity.x *= BALL_SPEED;
        ball_velocity.y *= BALL_SPEED;

        click_counter++;
    }

    if (clicked)
    {
        ball_position.x += ball_velocity.x * GetFrameTime();
        ball_position.y += ball_velocity.y * GetFrameTime();

        // 屏幕边缘碰撞逻辑不变...
        if (ball_position.x >= GetScreenWidth() - ball_texture.width || ball_position.x <= 0)
        {
            ball_velocity.x *= -1;
        }
        if (ball_position.y <= 0)
        {
            ball_velocity.y *= -1;
        }
        if (ball_position.y >= GetScreenHeight() - ball_texture.height - 150)
        {
            ball_position = {300,750};
            clicked = false;
        }
    }
}

4. 在场景切换时调用重置 #

在main.cpp的TITLE场景切换到GAMEPLAY时，调用重置函数：

case TITLE:
{
    int button_state = title_screen.getBtnState();
    
    if (button_state == 2)
    {
        currentScreen = GAMEPLAY;
        ball.resetBallState(); // 替换原setBallPosition()，确保所有状态清零
        isGameOver = false;
    }
} break;

同时在游戏触发结束逻辑时，也可以调用一次重置，避免状态残留：

if (click_counter > 10)
{
    isGameOver = true;
    ball.resetBallState(); // 重置小球状态
    DrawText("HaHaHaHA LOOOSER B!TCHES", GetScreenWidth() / 2 - 200, GetScreenHeight() / 2 - 50, 30, WHITE);

    if (!isExitButtonInitialized && currentScreen == GAMEPLAY)
    {
        gameplay_screen.initExitButton();
        isExitButtonInitialized = true;
    }
}

验证效果 #

修改完成后，测试流程：

1. 点击次数超过10次，触发游戏结束
2. 点击退出按钮回到标题页
3. 重新开始游戏，小球会停在初始位置，不会自动移动，直到再次点击鼠标才会触发移动，且计数正常

内容的提问来源于stack exchange，提问作者Onur Sevki Okan