最后同步日期：2026-04-15 | Godot 官方原文 — Input examples

输入处理

想象你在玩一个游戏机——按方向键移动角色、按 A 键跳跃、摇杆控制视角。输入处理函数就是 Godot 引擎的遥控器接口，帮你检测玩家按了什么键、鼠标移到了哪里、手柄摇杆推到了什么位置。

核心概念

• 动作映射：在项目设置中定义动作名称，代码中用名称检测输入。
• is_action_pressed：检测某个动作是否正在被按住。
• is_action_just_pressed：检测某个动作是否在本帧刚按下。
• get_vector：从四个方向动作获取一个 2D 向量，适合角色移动。

---

函数总览

函数名	描述	使用频率	详细文档
Input.action_press	程序化触发按下动作	★	查看
Input.action_release	程序化释放动作	★	查看
Input.get_axis	获取双动作轴值（-1 到 1）	★★	查看
Input.get_mouse_position	获取鼠标位置	★★	查看
Input.get_vector	从四个动作获取 2D 向量	★★★	查看
Input.is_action_just_pressed	动作是否在本帧刚按下	★★★	查看
Input.is_action_just_released	动作是否在本帧刚释放	★★	查看
Input.is_action_pressed	动作是否正在被按住	★★★	查看
Input.set_mouse_mode	设置鼠标模式	★★	查看
Input.warp_mouse	强制设置鼠标位置	★	查看