Unity新手必看：GetMouseButton和GetKey的3种状态详解（附实战代码）
Unity输入系统深度解析：GetMouseButton与GetKey的三种状态实战指南
刚接触Unity的开发者常常会困惑：为什么角色移动代码在长按按键时流畅运行，而射击逻辑却需要反复点击鼠标？这背后隐藏着Unity输入系统的核心机制——**瞬时检测（Down/Up）与持续检测（Stay）**的差异。本文将用FPS游戏开发实例，带你彻底掌握这三种状态的运用精髓。
1. 输入系统基础：三种状态的本质区别
Unity的Input类提供了三种检测模式，它们构成了所有交互逻辑的基石：
- Down状态（GetMouseButtonDown/GetKeyDown）：仅在按键接触瞬间返回true
- Stay状态（GetMouseButton/GetKey）：只要按键保持按下就持续返回true
- Up状态（GetMouseButtonUp/GetKeyUp）：仅在按键释放瞬间返回true
// 典型检测代码结构 void Update() { if (Input.GetMouseButtonDown(0)) { // 单次触发（如开枪） } if (Input.GetMouseButton(0)) { // 持续触发（如蓄力） } if (Input.GetKey(KeyCode.W)) { // 持续移动 } }关键理解：这三种状态在同一帧内可能同时触发。例如长按鼠标时，首帧触发Down，中间帧触发Stay，释放帧触发Up。
2. 鼠标输入的精细控制
2.1 按钮参数详解
| 参数值 | 对应按钮 | 典型应用场景 |
|---|---|---|
| 0 | 左键 | 主武器射击/选择对象 |
| 1 | 右键 | 瞄准/次要功能 |
| 2 | 中键 | 视角平移/特殊操作 |
2.2 实战：FPS射击系统
public class WeaponController : MonoBehaviour { [SerializeField] float fireRate = 0.2f; float nextFireTime; void Update() { // 半自动射击模式 if (Input.GetMouseButtonDown(0) && Time.time >= nextFireTime) { Shoot(); nextFireTime = Time.time + fireRate; } // 全自动射击模式 if (Input.GetMouseButton(0) && Time.time >= nextFireTime) { Shoot(); nextFireTime = Time.time + fireRate; } } void Shoot() { // 实例化子弹/射线检测等逻辑 } }2.3 高级技巧：鼠标位置追踪
// 获取屏幕坐标（左下角(0,0)，右上角(Screen.width,Screen.height)） Vector3 mousePos = Input.mousePosition; // 转换为世界坐标（2D游戏常用） Vector3 worldPos = Camera.main.ScreenToWorldPoint(mousePos); // 3D游戏中的射线检测 if (Input.GetMouseButtonDown(0)) { Ray ray = Camera.main.ScreenPointToRay(mousePos); if (Physics.Raycast(ray, out RaycastHit hit)) { Debug.Log("点击对象：" + hit.collider.name); } }3. 键盘输入的进阶应用
3.1 常用KeyCode枚举值
// 移动控制 KeyCode.W // 前进 KeyCode.S // 后退 KeyCode.A // 左移 KeyCode.D // 右移 KeyCode.Space // 跳跃 // 功能键 KeyCode.Escape // 暂停菜单 KeyCode.Tab // 打开背包 KeyCode.LeftShift // 冲刺3.2 角色移动系统优化
public class PlayerMovement : MonoBehaviour { [SerializeField] float moveSpeed = 5f; [SerializeField] float runMultiplier = 1.5f; void Update() { float currentSpeed = Input.GetKey(KeyCode.LeftShift) ? moveSpeed * runMultiplier : moveSpeed; Vector3 moveDir = Vector3.zero; if (Input.GetKey(KeyCode.W)) moveDir.z += 1; if (Input.GetKey(KeyCode.S)) moveDir.z -= 1; if (Input.GetKey(KeyCode.A)) moveDir.x -= 1; if (Input.GetKey(KeyCode.D)) moveDir.x += 1; if (moveDir != Vector3.zero) { transform.Translate( currentSpeed * Time.deltaTime * moveDir.normalized ); } } }性能提示：避免在Update中频繁调用Input.GetKeyDown。如需检测多个按键，优先使用Input.GetKey(KeyCode)配合状态机管理。
4. 状态组合的高级应用
4.1 复合输入检测
// 组合键示例：Ctrl+Shift+S if (Input.GetKey(KeyCode.LeftControl) && Input.GetKey(KeyCode.LeftShift) && Input.GetKeyDown(KeyCode.S)) { SaveGame(); } // 长按检测 float pressDuration = 0f; void Update() { if (Input.GetMouseButton(0)) { pressDuration += Time.deltaTime; if (pressDuration > 1f) { Debug.Log("长按超过1秒"); // 触发蓄力效果 } } else { pressDuration = 0f; } }4.2 输入缓冲技术
// 跳跃输入缓冲（允许提前几帧输入） float jumpBufferTime = 0.2f; float lastJumpPressTime = -1f; void Update() { if (Input.GetKeyDown(KeyCode.Space)) { lastJumpPressTime = Time.time; } if (IsGrounded() && Time.time - lastJumpPressTime <= jumpBufferTime) { Jump(); lastJumpPressTime = -1f; // 重置 } }5. 常见问题与调试技巧
5.1 输入失效排查清单
- 检查脚本是否挂载到活动GameObject
- 确认没有UI元素阻挡射线检测（检查EventSystem）
- 确保在Update()而非FixedUpdate()中检测输入
- 验证按键映射是否正确（特别是外接手柄时）
5.2 输入系统优化建议
- 对于移动端项目，考虑使用Unity的新输入系统（InputSystem）
- 复杂操作建议使用输入动作映射（Input Actions）
- 频繁检测的输入可以考虑用委托事件优化
// 事件化输入示例 public static event Action OnShootPressed; void Update() { if (Input.GetMouseButtonDown(0)) { OnShootPressed?.Invoke(); } }掌握这三种输入状态的区别，就如同获得了操控游戏交互的精准手术刀。在最近开发的潜行游戏中，我们巧妙组合GetKeyDown和GetKey，实现了"轻按潜行、长按冲刺"的细腻操作——这正体现了理解输入状态差异的实战价值。