Unity的Cursor.lockState

2025年8月24日，周日晚上

Cursor.lockState = CursorLockMode.Locked;这行代码在Unity中是​​将鼠标光标锁定到游戏窗口的中心，并隐藏鼠标光标​​。这是第一人称射击（FPS）、第三人称等类型游戏中实现视角控制的常用核心代码。

下面这个表格能帮你快速了解三种不同鼠标锁定模式的区别：

🔧 如何使用与注意事项

基本用法

通常，你会在玩家控制脚本的 Update()或 Start()方法中设置这些状态。

using UnityEngine;public class MouseControl : MonoBehaviour
{void Start(){// 锁定并隐藏鼠标Cursor.lockState = CursorLockMode.Locked;Cursor.visible = false; // 在Locked模式下，此行可省略，但明确设置是好习惯}void Update(){// 通常用ESC键来解锁鼠标，方便玩家操作if (Input.GetKeyDown(KeyCode.Escape)){Cursor.lockState = CursorLockMode.None;Cursor.visible = true;}// 再次点击鼠标时重新锁定（可选）if (Input.GetMouseButtonDown(0) && Cursor.lockState == CursorLockMode.None){Cursor.lockState = CursorLockMode.Locked;Cursor.visible = false;}}
}

重要注意事项

1. ​​版本差异​​：在较旧的Unity版本（如Unity4.x）中，使用的是 Screen.lockCursor属性。从Unity5.x开始，官方推荐使用 Cursor.lockState和 Cursor.visible来替代。

2. ​​Locked模式优先级最高​​：在 CursorLockMode.Locked模式下，无论 Cursor.visible的值设置为 true还是 false，硬件光标都会被强制隐藏。 因此，若需要光标可见，需先将锁定模式设为 None或 Confined。

3. ​​引擎自动处理​​：在编辑器中进行游戏测试时，Unity编辑器通常会自动处理鼠标锁定和解锁的切换。但当游戏获得焦点时，设定的状态会生效。

4. ​​平台差异​​：这些功能在绝大多数平台上都得到支持，但个别平台的具体行为可能存在细微差异，进行多平台发布时需进行测试。

💡 实战技巧：实现平滑的鼠标视角控制

当你锁定鼠标后，通常需要获取鼠标的移动输入来控制摄像机旋转。这里有一个简单的示例：

public class FPSCameraLook : MonoBehaviour
{public float mouseSensitivity = 100.0f;public Transform playerBody; // 玩家的父物体，用于左右旋转private float xRotation = 0f;void Update(){// 只有当鼠标被锁定时才处理视角旋转if (Cursor.lockState == CursorLockMode.Locked){float mouseX = Input.GetAxis("Mouse X") * mouseSensitivity * Time.deltaTime;float mouseY = Input.GetAxis("Mouse Y") * mouseSensitivity * Time.deltaTime;xRotation -= mouseY;xRotation = Mathf.Clamp(xRotation, -90f, 90f); // 限制上下抬头幅度transform.localRotation = Quaternion.Euler(xRotation, 0f, 0f);playerBody.Rotate(Vector3.up * mouseX);}}
}

⚠️ 常见问题排查

如果遇到鼠标行为异常，可以检查以下几点：

• ​​状态不同步​​：确保在所有需要改变光标状态的场景（如暂停游戏、打开菜单、切换场景）中都正确地更新了 Cursor.lockState和 Cursor.visible。

• ​​UI冲突​​：如果使用了复杂的UI系统（如Unity的UGUI或第三方插件），确保在打开UI界面时没有忘记解锁鼠标（设置为 CursorLockMode.None）。

• ​​帧率影响​​：极低的帧率可能会影响鼠标输入采样的平滑度，但这通常不影响锁定状态本身。

希望这些信息能帮助你更好地理解和使用Unity的鼠标锁定功能。