HTML5快捷键需在keydown事件中用code+修饰键标志精准匹配，过滤重复触发，分平台定义Cmd/Ctrl行为，避免误触与默认行为干扰。
在 HTML5 中，通过 KeyboardEvent 实现精准、可靠的快捷键组合（如 Ctrl+Shift+K、Cmd+Alt+T），关键不在于监听单个按键，而在于**正确理解事件触发时机、区分修饰键状态、避免重复触发，并处理跨平台差异**。
用 keydown 而非 keypress 或 keyup
keypress 已被废弃，且不提供可靠的 ctrlKey、metaKey 等修饰键信息；keyup 适合检测“松开”，但无法准确捕获组合键的按下意图（例如用户先按 Ctrl 再按 K，keyup 只在松开时触发，中间无法判断组合是否成立）。keydown 是唯一能同步获取所有修饰键状态 + 键盘码的可靠时机。
- 始终在
keydown事件中判断组合键 - 使用
event.preventDefault()阻止默认行为（如 Ctrl+T 打开新标签页） - 避免在
keydown中做耗时操作，防止阻塞 UI
精准识别修饰键与主键：别只依赖 key 或 code
event.key 表示语义字符（如 "Enter"、"a"），受输入法和大小写影响；event.code 表示物理按键（如 "KeyA"、"Enter"），更稳定。但快捷键逻辑通常关注「用户意图」——比如 Ctrl+S 应该在任意输入法/大小写下都生效，所以推荐：
- 用
event.code判断物理按键（如"KeyS"、"Digit9"） - 用
event.ctrlKey、event.shiftKey、event.altKey、event.metaKey判断修饰键 - 注意：Mac 上
Cmd对应metaKey，Windows/Linux 上Ctrl对应ctrlKey；不要硬写ctrlKey || metaKey，而应按平台约定分别处理或统一映射
防误触与防重复：加锁 + 检查按键序列完整性
用户可能快速连按、误触修饰键，或系统自动重复触发（长按）。需主动过滤：
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记（深入）”；
- 用
event.repeat === false过滤系统自动重复（Chrome/Firefox 支持） - 维护一个 Set 记录当前按下的键码（
event.code），在keydown中加入，在keyup中移除；仅当目标组合键全部存在于该 Set 中时才触发逻辑（适用于复杂组合如 Ctrl+Alt+Shift+Z） - 对高频快捷键（如撤销/重做），可加 50ms 去抖，避免双击误判
跨平台兼容：明确区分 Cmd 和 Ctrl，适配 Mac 用户习惯
Mac 用户期望 Cmd+C 复制，Windows 用户用 Ctrl+C。不能简单合并处理：
- 定义快捷键配置时，用对象区分平台：
{ mac: 'meta+k', win: 'ctrl+k' } - 运行时通过
navigator.platform.includes('Mac')或navigator.userAgent.includes('Mac')判断平台 - 避免同时监听
ctrlKey和metaKey触发同一功能——这会导致 Mac 用户按 Cmd+K 时，Ctrl+K 的副作用也被激活（如焦点跳转） - 可借助开源库如 Mousetrap 或 hotkeys-js，它们已内置平台适配与组合键解析
不复杂但容易忽略：快捷键不是“监听到键就执行”，而是“确认用户明确表达了该组合意图”。抓住 keydown 时机、用 code + 修饰键标志精准匹配、加锁防干扰、分平台定义行为——四步到位，就能支撑编辑器、IDE、看板等复杂场景的快捷键体系。
