event.key 表示输入意图(如字符或功能语义),受输入法、修饰键等影响;event.code 标识物理按键位置(如"KeyA"),与布局、状态无关,适合快捷键和游戏控制。

用 event.key 和 event.code 区分“按的是哪个键”和“输入的是什么字符”,关键在于理解它们的设计目的:前者反映**语义结果**(你想要输入的内容),后者反映**物理位置**(键盘上哪个键被按下)。
event.code:锁定物理按键位置,与布局无关
event.code 始终返回按键在标准 QWERTY 键盘上的**物理位置标识**,比如 "KeyA"、"Digit1"、"Escape"。它不随系统语言、输入法、Shift 状态或 Caps Lock 变化。
- 按住 Shift + A(无论当前是英文还是中文输入法),
event.code都是"KeyA" - 在法语 AZERTY 键盘上按最左上角的字母键(对应 QWERTY 的 A 位),
event.code仍是"KeyA",哪怕实际输出是"q" - 数字小键盘的
"1"和主键盘的"1"返回不同值:"Numpad1"vs"Digit1",方便精确区分
event.key:反映当前输入意图,受上下文影响
event.key 表示该次按键**产生的可打印字符或功能含义**,会随修饰键、输入法、Caps Lock 实时变化。
- 英文输入下:按 A →
key = "a";按 Shift+A →key = "A";Caps Lock 开着按 A →key = "A" - 中文输入法中:按 A 键可能处于编码状态,此时
event.key通常是"Unidentified"或空字符串,因为尚未生成有效字符 - 功能键如 Enter、Tab、ArrowUp,
event.key直接返回语义名:"Enter"、"Tab"、"ArrowUp"
典型场景下的配合使用建议
单纯监听快捷键(如 Ctrl+S 保存)应优先用 event.code 判断按键位置,再结合 event.ctrlKey 等修饰键判断组合;而处理文本输入(如密码强度检测、自动补全)则依赖 event.key 获取真实字符。
- 做游戏方向控制?用
event.code === "ArrowLeft"更可靠,避免用户切换输入法后失效 - 实现「按 Backspace 删除光标前字符」?用
event.key === "Backspace",因为它明确表示删除意图 - 需要屏蔽某些物理键(如禁用 F5 刷新)?监听
event.code === "F5"并preventDefault() - 记录用户实际输入内容?监听
input事件比keydown更准确,因为event.key在组合输入(如中文拼音)中不可靠
注意兼容性与边界情况
IE 不支持 event.code 和部分 event.key 值(如 "Meta"),需降级处理;老版本 Safari 对某些组合键的 key 返回 "Unidentified"。遇到无法识别的键,可回退到 event.keyCode(已废弃但仍有支持)或 event.which 做粗略映射,不过更推荐用现代库(如 keycode 或 keyboard-key)封装兼容逻辑。

















