本文介绍如何使用 pygame zero 实现鼠标锁定（隐藏且限制在窗口边界内）、esc 暂停/解锁、以及点击恢复游戏的完整交互逻辑，并给出可直接运行的优化代码。
本文介绍如何使用 pygame zero 实现鼠标锁定（隐藏且限制在窗口边界内）、esc 暂停/解锁、以及点击恢复游戏的完整交互逻辑，并给出可直接运行的优化代码。
在 PyGame Zero（PGZ）中，虽然其 API 屏蔽了底层 Pygame 的部分细节，但你仍可通过 pygame 模块直接调用底层功能来实现高级鼠标控制。核心需求有三点：
- 游戏运行时：隐藏鼠标 + 锁定在窗口内（防止移出导致视角失控）；
- 按 ESC 时：显示鼠标、释放锁定、暂停游戏；
- 点击窗口任意位置时：重新隐藏并锁定鼠标，恢复游戏。
关键在于 pygame.event.set_grab() —— 它并非“隐藏鼠标”，而是强制将鼠标光标捕获在窗口区域内（即“软锁定”），配合 pygame.mouse.set_visible(False) 即可实现沉浸式第一人称/自由视角体验。
⚠️ 注意：set_grab(True) 仅在窗口获得焦点且处于活动状态时生效；若窗口最小化或失焦，系统会自动释放抓取。因此需确保游戏窗口始终处于前台（PGZ 默认满足）。
以下是经过重构、修复逻辑错误（如避免递归调用 start()）并增强健壮性的完整代码：
import pgzrun
import pygame
WIDTH = 800
HEIGHT = 600
# 全局状态
playing = True
mouse_grabbed = False
def start_game():
global playing, mouse_grabbed
playing = True
pygame.mouse.set_visible(False)
pygame.event.set_grab(True) # ? 锁定鼠标在窗口内
mouse_grabbed = True
def pause_game():
global playing, mouse_grabbed
playing = False
pygame.mouse.set_visible(True)
pygame.event.set_grab(False) # ? 解除锁定
mouse_grabbed = False
def on_key_down(key):
if key == keys.ESCAPE:
if playing:
pause_game()
def on_mouse_down(pos):
# 点击任意位置（仅当处于暂停状态时生效）
if not playing:
start_game()
def update():
# 游戏主逻辑（此处可添加角色移动、视角更新等）
pass
def draw():
screen.clear()
if not playing:
screen.draw.text("PAUSED", (WIDTH//2 - 100, HEIGHT//2 - 50),
color="white", fontsize=60)
screen.draw.text("Click anywhere to resume", (WIDTH//2 - 180, HEIGHT//2 + 20),
color="lightgray", fontsize=32)
# 初始化
start_game()
pgzrun.go()✅ 关键改进说明：
- 使用 on_key_down 和 on_mouse_down 回调替代轮询 keyboard.Escape 和 mouse.LEFT，更符合 PGZ 事件驱动规范，避免帧率依赖与误触发；
- 移除了 update() 中递归调用 start() 的危险逻辑（会导致栈溢出）；
- 显式管理 mouse_grabbed 标志，便于调试与扩展；
- pygame.event.set_grab() 必须在窗口已创建后调用（PGZ 启动后即满足），且建议与 set_visible() 配对使用。
? 补充提示：
- 在 Linux 系统上，若锁定失效，请确认窗口管理器未禁用抓取（多数桌面环境默认允许）；
- 若需支持多显示器全屏模式，应改用 pygame.display.set_mode(..., pygame.FULLSCREEN) 并配合 pygame.mouse.set_pos() 辅助居中；
- 此方案适用于 FPS、模拟驾驶等需要精确鼠标输入的场景，但不适用于需鼠标拖拽 UI 的游戏——此时应切换为非锁定模式。
现在，你的游戏已具备专业级鼠标控制能力：沉浸、响应及时、状态清晰、易于维护。
