如何阻止光标移出GLFW窗口范围，实现自由相机移动？

1. 确认GLFW光标禁用的调用时机与正确性 #

GLFW_CURSOR_DISABLED 必须在窗口创建完成后调用，且GLFW版本建议使用3.0及以上（3.3+稳定性更佳）。另外，窗口失去焦点时GLFW会自动恢复光标状态，需监听焦点事件重新锁定：

void windowFocusCallback(GLFWwindow* window, int focused) {
    if (focused) {
        glfwSetInputMode(window, GLFW_CURSOR, GLFW_CURSOR_DISABLED);
        // 焦点恢复时重置光标到窗口中心，避免偏移异常
        int width, height;
        glfwGetWindowSize(window, &width, &height);
        glfwSetCursorPos(window, width / 2.0, height / 2.0);
    }
}

// 窗口创建后注册该回调
glfwSetWindowFocusCallback(window.self, windowFocusCallback);

2. 修正鼠标回调的初始化逻辑 #

lastX和lastY必须在首次鼠标事件前完成初始化，否则首次移动会产生异常偏移。建议在窗口初始化阶段将其设为窗口中心：

// 全局/结构体变量初始化
float lastX = window.width / 2.0f;
float lastY = window.height / 2.0f;
bool firstMouse = true; // 标记首次鼠标输入

void cameraMouseCallback(double xposIn, double yposIn) {
    float xpos = (float)xposIn;
    float ypos = (float)yposIn;

    // 首次输入跳过偏移计算，直接更新初始位置
    if (firstMouse) {
        lastX = xpos;
        lastY = ypos;
        firstMouse = false;
        return;
    }

    float xoffset = xpos - lastX;
    float yoffset = lastY - ypos; 
    lastX = xpos;
    lastY = ypos;

    xoffset *= camera.sensitivity;
    yoffset *= camera.sensitivity;

    yaw += xoffset;
    pitch += yoffset;

    // 限制俯仰角，避免画面翻转
    if (pitch > 89.0f) pitch = 89.0f;
    if (pitch < -89.0f) pitch = -89.0f;

    vec3 front;
    front[0] = cos(glm_rad(yaw)) * cos(glm_rad(pitch));
    front[1] = sin(glm_rad(pitch));
    front[2] = sin(glm_rad(yaw)) * cos(glm_rad(pitch));

    glm_vec3_normalize(front);
    glm_vec3_copy(front, cameraFront);
}

3. 移除手动重置光标位置的冗余代码 #

启用GLFW_CURSOR_DISABLED后，GLFW会自动隐藏光标并将其锁定在窗口内，无需在每次鼠标回调中调用glfwSetCursorPos——这反而可能导致逻辑冲突。仅需在初始化或焦点恢复时执行一次位置重置即可。

4. 验证光标模式设置是否成功 #

可添加错误检查，确认光标禁用操作是否生效：

if (!glfwSetInputMode(window.self, GLFW_CURSOR, GLFW_CURSOR_DISABLED)) {
    fprintf(stderr, "Failed to disable cursor: %s\n", glfwErrorString(glfwGetError()));
}

关键注意事项 #

• 仅能在窗口处于激活状态时锁定光标，后台窗口无法完成该操作。
• 依赖GLFW的原生光标锁定逻辑，避免手动干预光标位置引发的异常。

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