# 键盘按键码在线查询 - event.key、event.code、keyCode 实时显示与对照表

> 免费在线 JavaScript 键盘事件查看器：按下任意键即时显示 event.key、code、keyCode、location、修饰键和重复状态，屏幕键盘高亮，附按键对照表与可复制代码。

- 网址: https://qilingtools.com/zh/keycode
- 分类: 开发工具 (https://qilingtools.com/zh/dev)
- 标签: [开发](https://qilingtools.com/zh/tags/dev), [前端网页](https://qilingtools.com/zh/tags/frontend)
- 最后更新: 2026-10-26
- 价格: 免费，无需注册
- 隐私: 在浏览器本地处理，文件不上传服务器

写快捷键、游戏操作或表单交互时，经常需要知道某个键在 JavaScript 里到底是什么值。打开本页按下任意键，就会大字显示组合键名称以及 event.key、event.code、keyCode、which、location（左 / 右 / 小键盘）、repeat、isComposing 和 Ctrl、Shift、Alt、Meta、CapsLock 状态。下方的美式布局屏幕键盘会高亮当前按下和按过的键，也可以用来检查键盘是否有失灵的按键。按键历史表记录最近的 keydown（可选 keyup）事件；输入法测试框会显示 compositionstart / update / end 事件，帮助理解中文输入时 keyCode 为 229 的情况。根据最后一次按键可一键生成按 key 或按 code 判断的 addEventListener 代码片段。页面底部是可搜索的常用按键对照表，列出 key、code 与 keyCode。注意 keyCode 和 which 已被标准废弃，新代码建议使用 key 或 code。

## 使用步骤

1. 点击页面空白处让本页获得焦点，然后按下任意键或组合键
2. 查看 event.key、code、keyCode 等属性，屏幕键盘会高亮对应按键
3. 复制自动生成的判断代码，或在下方对照表中搜索其它按键

## 功能特点

- 实时显示 key、code、keyCode、which、location、repeat、isComposing
- 修饰键状态与组合键名称
- 美式布局屏幕键盘高亮，可做键盘检测
- 按键历史表（可记录 keyup）
- 输入法合成事件测试
- 一键复制按 key / code 判断的 JS 代码
- 可搜索的常用按键对照表

## 常见问题

### event.key、event.code 和 keyCode 有什么区别？

event.key 表示按键产生的字符或功能名，会随键盘布局和 Shift 变化（如 "a"、"A"、"Enter"）；event.code 表示物理按键位置，与布局无关（如 "KeyA"、"ShiftLeft"），适合游戏 WASD 这类按位置的操作；keyCode 是旧的数字编码，已被标准废弃，不同浏览器、布局下可能不一致，新代码不建议再使用。

### 为什么有些按键或快捷键在页面上检测不到？

Ctrl+W、Ctrl+T、Cmd+Q 等浏览器和操作系统保留的快捷键会被直接处理，网页无法拦截；Fn 键通常不会产生事件；部分多媒体键取决于系统和浏览器。另外必须让本页获得焦点，焦点在地址栏或其它窗口时收不到按键。

### 中文输入法下 keyCode 为什么总是 229？

使用输入法组字时，浏览器会把 keydown 的 key 设为 "Process"、keyCode 设为 229，并把 isComposing 设为 true，真正的文字要在 compositionend 或 input 事件里获取。处理快捷键时应先判断 event.isComposing，避免在用户选字时误触发，本工具生成的代码已包含这一判断。

### 可以用它测试键盘有没有坏键吗？

可以。屏幕键盘会把按过的键标成浅蓝色，正在按下的键标成深蓝色，依次按一遍所有按键，没有变色的就是没被识别的键。也可以同时按住多个键测试键盘的无冲（多键同时识别）能力。

## 相关工具

- [JSON 格式化](https://qilingtools.com/zh/json): 免费在线 JSON 格式化：一键美化、压缩，实时语法校验并定位到出错行列，支持树形视图折叠、键名排序、转义与去转义、Unicode 转中文、复制下载，数据不上传。
- [Base64 编解码](https://qilingtools.com/zh/base64): 免费在线 Base64 编码解码工具：支持中文 UTF-8、URL 安全变体，文本与 Base64 互转，实时转换，本地处理不上传。
- [URL 编解码](https://qilingtools.com/zh/url-encode): 免费在线 URL 编码解码工具：encodeURIComponent 与 encodeURI 两种模式，处理中文、空格与特殊符号，本地实时转换不上传。
- [JWT 解析](https://qilingtools.com/zh/jwt): 免费在线 JWT 解析工具：解码 JWT 的 Header 与 Payload，展示过期时间、签发时间等，本地解析不上传，保护令牌安全。
- [时间戳转换](https://qilingtools.com/zh/timestamp): 免费在线 Unix 时间戳转换工具：时间戳与日期互转，自动识别秒/毫秒，显示本地时间、UTC、ISO 8601 和相对时间，实时更新。
- [哈希计算](https://qilingtools.com/zh/hash): 免费在线哈希/摘要计算工具：对文本或文件计算 SHA-1、SHA-256、SHA-384、SHA-512，使用浏览器加密接口本地完成，文件不上传。
- [UUID 生成](https://qilingtools.com/zh/uuid): 免费在线 UUID 生成器：使用加密安全随机数批量生成符合 RFC 4122 的 UUID v4，可大写、去连字符、加花括号，一键复制。
- [进制转换](https://qilingtools.com/zh/base-convert): 免费在线进制转换工具：二进制、八进制、十进制、十六进制及任意 2–36 进制互转，支持大整数（BigInt），本地实时计算。