如何通过键盘快捷键重新打开已最小化的Tauri应用

你当前的键盘事件监听绑定在浏览器document对象上，当窗口最小化或隐藏后，页面处于非活跃状态，无法捕获键盘事件，因此快捷键无法触发恢复操作。解决核心是改用Tauri提供的全局快捷键API，它能在系统层面捕获按键，不受窗口状态影响。

解决方案步骤 #

1. 注册全局快捷键：使用Tauri的registerGlobalShortcut API，在应用初始化时完成注册
2. 状态判断与切换：触发快捷键时，先检测当前窗口状态，执行最小化/恢复、隐藏/显示的对应操作
3. 清理资源：组件卸载时注销全局快捷键，避免内存泄漏

完整代码示例 #

import { useEffect } from 'react';
import { appWindow, registerGlobalShortcut, unregisterGlobalShortcut } from '@tauri-apps/api/window';

const App = () => {
  useEffect(() => {
    const setupGlobalShortcuts = async () => {
      // 注册 Ctrl+T：切换窗口最小化/恢复状态
      await registerGlobalShortcut('Control+T', async () => {
        const isMinimized = await appWindow.isMinimized();
        if (isMinimized) {
          await appWindow.unminimize();
          await appWindow.setFocus();
        } else {
          await appWindow.minimize();
        }
      });

      // 注册 Ctrl+W：切换窗口隐藏/显示状态
      await registerGlobalShortcut('Control+W', async () => {
        const isVisible = await appWindow.isVisible();
        if (isVisible) {
          await appWindow.hide();
        } else {
          await appWindow.show();
          await appWindow.setFocus();
        }
      });
    };

    setupGlobalShortcuts();

    // 组件卸载时注销快捷键
    return async () => {
      await unregisterGlobalShortcut('Control+T');
      await unregisterGlobalShortcut('Control+W');
    };
  }, []);

  return (
    <div>你的应用内容</div>
  );
};

export default App;

关键说明 #

• 移除原有的document.addEventListener代码，全局快捷键无需依赖页面活跃状态
• appWindow.isMinimized()/appWindow.isVisible()用于判断当前窗口状态，实现双向切换
• 恢复窗口后调用setFocus()确保窗口立即获得焦点
• 必须在组件卸载时注销快捷键，避免重复注册导致的异常

内容的提问来源于stack exchange，提问作者Anirudh Panchangam Ranganath