应根据需求选择:识别字符用event.key(受输入法、修饰键影响),识别物理键用event.code(固定位置,与布局无关);keycode和which已废弃,禁用。

直接用 event.key 或 event.code,别碰 keyCode 和 which —— 它们已废弃,行为不一致,现代浏览器里随时可能出错。
keydown 里该读 event.key 还是 event.code
取决于你要识别“按出了什么字符”还是“按了哪个物理键”:
• event.key 返回语义值:按 A 键(无论 CapsLock/Shift 状态)返回 "a" 或 "A";按 Enter 返回 "Enter";只按 Ctrl 返回 "Control"。
• event.code 返回物理位置:主键盘区 A 键永远是 "KeyA",左侧 Shift 是 "ShiftLeft",右侧是 "ShiftRight",不受输入法、大小写、布局影响。
• 长按 Tab / 方向键时,key 可能为 "Tab" / "ArrowDown",code 同样稳定为 "Tab" / "ArrowDown"。
• 浏览器快捷键(如 F5 刷新、Alt+D 聚焦地址栏)通常被系统拦截,keydown 根本不会触发 —— 别指望靠它捕获这些。
keyup 中 event.key 的大小写陷阱
keyup 的 event.key 值受松开瞬间的修饰键状态影响,不是按下时的状态:
• 按住 Shift + A 再松开 A 键(Shift 仍按着),keyup 的 key 是 "A";
• 松开 Shift 后再松开 A,keyup 的 key 就是 "a"。
• 所以不能靠单次 keyup.key 反推组合键意图。需要结合 event.shiftKey、event.ctrlKey 等布尔属性判断修饰键是否仍激活。
• event.code 在 keyup 中依然稳定,比如松开左 Shift 总是 "ShiftLeft",和松开时机无关。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
监听范围与事件绑定方式选哪个
全局响应(如游戏控制、快捷键)绑 document;局部响应(如输入框内回车提交)优先绑具体元素:
• 用 addEventListener('keydown', handler),不要用 onkeydown 内联属性 —— 后者无法叠加、难调试、逻辑耦合重。
• 若需阻止默认行为(如禁用 F5 刷新、禁用空格在 contenteditable 中滚动),必须在 keydown 阶段调用 event.preventDefault();keyup 太晚,多数默认行为已执行。
• 不要监听 keypress:它不触发功能键(Ctrl/Alt/方向键等),且已被标准弃用,Chrome/Firefox 已逐步限制其行为。
兼容性与容易忽略的细节
现代项目(2026 年)基本可放弃 IE 兼容,但仍有几个点容易翻车:
• event.key 在旧版 Safari(≤15.6)对某些组合键返回空字符串,建议加空值 fallback:const key = event.key || event.code。
• event.code 对多媒体键(如音量调节)支持不一,部分设备返回 "AudioVolumeUp",部分返回 "Unidentified"。
• 输入法上屏前的按键(如中文拼音输入时按 “a”、“s” 构词)会触发 keydown,但 event.key 是 "Process" 或 "Unidentified",此时应检查 event.isComposing 判断是否处于输入法编辑中。
• 如果你监听的是 input 元素,注意聚焦状态:没聚焦时 keydown 不会冒泡到它,除非显式设置 tabindex。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










