10.4 全局快捷键：注册、注销、冲突处理

在桌面应用中，全局快捷键能让用户哪怕不切换到应用窗口也能快速执行操作（例如一键截图、呼出面板）。Tauri 通过 global-shortcut 插件（或 Rust API）提供了对全局快捷键的完整支持。下面分别说明注册、注销以及冲突处理的最佳实践。

1. 注册全局快捷键

使用插件前，需先在 Cargo.toml 和前端依赖中添加 tauri-plugin-global-shortcut。然后在 Rust 侧初始化插件，并在前端通过 JS 调用注册。

Rust 侧初始化（main.rs 或 lib.rs）：

fn main() {
    tauri::Builder::default()
        .plugin(tauri_plugin_global_shortcut::Builder::new().build())
        .run(tauri::generate_context!())
        .expect("启动失败");
}

前端注册快捷键（以 React 为例）：

import { register } from '@tauri-apps/plugin-global-shortcut';

// 注册 Ctrl+Shift+K
await register('CommandOrControl+Shift+K', (event) => {
  console.log('快捷键被触发了！', event.state);
});

修饰键：CommandOrControl 可在 macOS 上自动转为 Cmd，其他平台为 Ctrl。
按键组合：支持多个修饰键并用 + 连接，例如 Alt+Shift+F12。完整的键码列表可参考 Tauri 文档。
注册时机：建议在应用启动后统一注册，或按需在用户进入特定页面时注册，避免未使用的快捷键占用系统资源。

2. 注销全局快捷键

不再需要某个快捷键时，应及时注销以释放系统资源并避免误触发。

import { unregister } from '@tauri-apps/plugin-global-shortcut';

// 注销指定快捷键
await unregister('CommandOrControl+Shift+K');

批量注销：可以使用 unregisterAll() 清空所有已注册的快捷键。
窗口隐藏时的处理：如果希望快捷键仅在应用可见时生效，可在窗口获得或失去焦点时动态注册/注销，以避免后台持续占用。

实际开发中，一个常见的模式是将注册和注销绑定在组件的生命周期里：

useEffect(() => {
  register('CommandOrControl+Shift+K', handler);
  return () => {
    unregister('CommandOrControl+Shift+K');
  };
}, []);

3. 冲突处理

不同应用可能争抢同一个全局快捷键，Tauri 并不能“强制”占有某个组合键，而是由操作系统决定优先级。当注册失败时（通常后台 API 返回错误），需要给用户明确的提示。

注册前检测：Tauri 的 isRegistered 方法可以检查当前应用是否已注册某个快捷键，但无法检测其他应用是否占用。

  import { isRegistered } from '@tauri-apps/plugin-global-shortcut';
  const taken = await isRegistered('CommandOrControl+Shift+K');

注册失败的兜底：对 register 调用进行 try-catch 错误处理，告知用户修改快捷键。

  try {
    await register('CommandOrControl+Shift+K', handler);
  } catch (error) {
    console.error('快捷键注册失败，可能被其他应用占用：', error);
    // 提示用户前往设置页更换组合键
  }

用户自定义快捷键：在应用的设置界面提供一个“快捷键录制”组件，让用户自定义组合，并在保存前尝试注册。如果失败，实时提示冲突并建议更换。这远比硬编码快捷键更友好，也符合大多数专业工具的习惯（如 VS Code、OBS）。
平台差异：macOS 的媒体键和系统快捷键（如 Spotlight）优先级最高，几乎无法被覆盖。非必要的全局快捷键应尽量避免与系统保留组合键冲突。

实用建议

谨慎使用：全局快捷键是“侵入式”的系统资源，不要滥用。每个快捷键都应提供明确的价值和关闭选项。
安装与卸载时的清理：应用卸载时，操作系统通常会释放之前注册的快捷键。但手动 unregisterAll() 能确保干净退出。
Nsis / MSI 打包：打包为安装程序时，提示用户应用需要全局快捷键权限（尤其在 macOS 上需要辅助功能权限），避免用户首次使用时因权限不足而困惑。

通过良好的注册、注销和冲突处理策略，你的 Tauri 应用就能像原生应用一样，提供顺滑的全局快捷键体验，而不会给用户带来键位冲突的困扰。