Unity使用ESC键实现游戏暂停/恢复功能出现异常

问题现象 #

• 注释Unpause方法中「隐藏UI、重置Time.timeScale为1」的代码行时，按下ESC键可正常触发暂停，游戏冻结符合预期
• 取消该行代码注释后功能整体异常：PauseGame方法逻辑表面执行（Debug日志打印Time.timeScale = 0），但游戏实际未进入冻结状态，暂停失效
  相关代码及日志参考：
  
  
  
  
  

排查与修复方案 #

1. 优先修复按键逻辑无互斥锁问题（90%概率为该原因） #

当前ESC按键监听逻辑未做严格的状态互斥判断，同一帧内会出现暂停、恢复逻辑连续触发的问题：

• 取消Unpause方法内timeScale重置代码注释后，按下ESC的帧内可能先执行PauseGame将timeScale设为0，紧接着因为无状态拦截，又触发Unpause将timeScale改回1。方法内的Debug日志仅能打印执行到该行的瞬时值，无法体现帧结束时timeScale的最终值，因此会出现「日志显示为0但游戏未暂停」的现象。
• 修复代码参考，给按键逻辑加严格的状态分支判断，禁止互斥逻辑同帧执行：

// 全局暂停状态标记
private bool isPaused = false;

void Update()
{
    // 仅在ESC按下的帧触发一次判断
    if (Input.GetKeyDown(KeyCode.Escape))
    {
        if (isPaused)
        {
            UnpauseGame();
        }
        else
        {
            PauseGame();
        }
    }
}

void PauseGame()
{
    isPaused = true;
    Time.timeScale = 0;
    // 暂停菜单显示逻辑放这里
    pauseMenu.SetActive(true);
}

void UnpauseGame()
{
    isPaused = false;
    Time.timeScale = 1;
    // UI隐藏逻辑放这里
    pauseMenu.SetActive(false);
}

注意：不要在PauseGame/UnpauseGame内部互相调用，也不要在状态切换时重复反转isPaused标记，避免递归触发。

2. 排查全局Time.timeScale非法篡改 #

• 全局搜索项目中所有给Time.timeScale赋值的代码，检查是否有UI动画控制器、场景加载脚本、其他全局管理类逻辑，在暂停逻辑执行后自动把timeScale改回1
• 可以封装一个全局的TimeScale管理属性，所有修改timeScale的操作必须经过该属性，每次赋值时打印调用栈，即可快速定位非法修改的来源：

public static class GlobalTimeManager
{
    private static float _currentTimeScale = 1f;
    public static float TimeScale
    {
        get => _currentTimeScale;
        set
        {
            _currentTimeScale = value;
            Time.timeScale = value;
            // 打印调用栈方便定位
            UnityEngine.Debug.Log($"TimeScale被修改为{value}, 调用栈：{System.Environment.StackTrace}");
        }
    }
}

3. 排查UI事件的连锁触发 #

Unpause方法中被注释的UI隐藏代码，大概率触发了连锁回调：

• 检查暂停菜单UI的OnEnable/OnDisable事件，是否绑定了修改timeScale的逻辑
• 检查CloseAllMenus方法、UI按钮的点击回调，是否存在写死重置timeScale为1的逻辑，和暂停/恢复逻辑冲突
• 验证方式：先注释掉所有UI显隐相关代码，仅保留timeScale赋值和状态切换逻辑，确认暂停功能正常后，再逐行加回UI代码，定位到触发冲突的具体逻辑行。

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