Vue 3 中 useKeyboardShortcut 封装快捷键监听，通过 onMounted/onUnmounted 管理生命周期，支持组合键解析（如 "Ctrl+S"）、动态启停、多快捷键绑定及作用域限定。

在 Vue 3 的 setup 中封装键盘快捷键监听，核心是用 onMounted 和 onUnmounted 管理事件生命周期，并通过 ref 或 reactive 暴露状态和控制方法。关键在于避免重复绑定、支持组合键（如 Ctrl+S）、可动态启用/禁用，且不污染全局。

定义快捷键配置与匹配逻辑

快捷键本质是判断 event.key、event.ctrlKey、event.altKey、event.metaKey、event.shiftKey 的组合。建议把快捷键规则写成可读性高的字符串（如 "Ctrl+S"），再解析匹配：

• 统一转为小写处理，忽略大小写差异（S 和 s 都匹配）
• 支持常见别名： "Cmd" → metaKey（macOS），"Ctrl" → ctrlKey
• 用 event.code 更稳定（如 "Enter"），但 key 更直观（如 "s"），推荐优先用 key，特殊场景（如防止输入法干扰）再切 code

封装 useKeyboardShortcut 函数

返回一个响应式对象，含 isActive 控制开关、bind 手动绑定、unbind 清理，以及快捷键触发回调：

Ainative Vue Sdk

使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景：(1) 安装 `@ainative/vue-sdk`，(2) 在 Vue 组件中使用 `useChat` 组合式函数，(3) 提供……

下载

import { onMounted, onUnmounted, ref, reactive } from 'vue'

export function useKeyboardShortcut() {
  const isActive = ref(true)
  const listeners = reactive(new Map())

  const normalizeKey = (key) => key.toLowerCase()
  const parseShortcut = (shortcut) => {
    const parts = shortcut.split('+').map(s => s.trim())
    return {
      key: normalizeKey(parts.pop()),
      ctrl: parts.includes('Ctrl') || parts.includes('Control'),
      alt: parts.includes('Alt'),
      shift: parts.includes('Shift'),
      meta: parts.includes('Cmd') || parts.includes('Meta')
    }
  }

  const matches = (e, config) => {
    if (e.key.toLowerCase() !== config.key) return false
    if (config.ctrl && !e.ctrlKey) return false
    if (config.alt && !e.altKey) return false
    if (config.shift && !e.shiftKey) return false
    if (config.meta && !e.metaKey) return false
    return true
  }

  const addListener = (shortcut, handler) => {
    const config = parseShortcut(shortcut)
    const listener = (e) => {
      if (!isActive.value) return
      if (matches(e, config)) {
        e.preventDefault()
        handler(e)
      }
    }
    window.addEventListener('keydown', listener)
    listeners.set(shortcut, { handler, listener })
  }

  const removeListener = (shortcut) => {
    const entry = listeners.get(shortcut)
    if (entry) {
      window.removeEventListener('keydown', entry.listener)
      listeners.delete(shortcut)
    }
  }

  const bind = (shortcut, handler) => {
    addListener(shortcut, handler)
  }

  const unbind = (shortcut) => {
    removeListener(shortcut)
  }

  const clearAll = () => {
    listeners.forEach((_, shortcut) => removeListener(shortcut))
  }

  onMounted(() => {
    // 自动清理（可选）
  })

  onUnmounted(() => {
    clearAll()
  })

  return {
    isActive,
    bind,
    unbind,
    clearAll
  }
}

在组件中使用

直接解构调用，支持多个快捷键，也支持运行时启停：

立即学习“前端免费学习笔记（深入）”；

import { defineComponent, onMounted } from 'vue'
import { useKeyboardShortcut } from './useKeyboardShortcut'

export default defineComponent({
  setup() {
    const { isActive, bind, unbind } = useKeyboardShortcut()

    const onSave = () => console.log('保存触发')
    const onUndo = () => console.log('撤销触发')

    onMounted(() => {
      bind('Ctrl+S', onSave)
      bind('Ctrl+Z', onUndo)
      // 支持 Cmd+S（macOS）
      bind('Cmd+S', onSave)
    })

    const toggleShortcut = () => {
      isActive.value = !isActive.value
    }

    return () => (
      <div>
        <button onClick={toggleShortcut}>
          {isActive.value ? '禁用快捷键' : '启用快捷键'}
        </button>
      </div>
    )
  }
})

进阶建议：支持作用域与防抖

若需限定快捷键只在某元素聚焦时生效（如仅编辑器内响应 Ctrl+S），可传入 targetRef，监听该元素的 keydown 而非 window；高频快捷键（如实时搜索）可加 useThrottleFn 包裹 handler，避免连按触发多次。