键盘按键测试
检测键盘按键是否正常，识别按键 key/code，测试组合键并统计按键次数
按键次数
0
已测试按键
0
当前按下
0
Fn 键、部分系统键和特殊媒体键可能无法被网页准确识别。绿色按键表示已测试通过。
这是什么工具？
键盘按键测试工具可以检测键盘每个按键是否正常工作。实时显示按下的按键、key/code 属性，支持虚拟键盘高亮、按键历史记录和组合键测试。所有检测在浏览器本地完成，不上传任何数据。适用于检测机械键盘、笔记本键盘、外接键盘是否有按键失灵或连击。
如何使用？
- 1 点击页面激活按键监听
- 2 按下键盘上的任意按键
- 3 查看虚拟键盘高亮和按键信息
- 4 查看按键历史记录和组合键状态
常见问题
能检测所有按键吗？
大部分普通按键可以，Fn 键、系统键、特殊媒体键可能无法识别。
可以测试机械键盘吗？
可以，用于检测按键是否触发、是否连击或失灵。
数据会上传吗？
不会，按键检测在本地浏览器完成。
适用场景与示例
- 检测新买的机械/外接键盘是否有按键失灵或连击
- 排查笔记本上某些按键不响应
- 查看按键的 key/code 属性，辅助前端开发
- 测试组合键（Ctrl/Shift/Alt + 字母）是否正常触发
输入
按下字母 A 键
输出
key='a' code='KeyA'，虚拟键盘 A 键高亮
💡 key 是逻辑键名，code 是物理位置；Shift+a 时 key 会变成 A，code 不变。
原理与常见错误
键盘测试依赖浏览器的 KeyboardEvent：每次按键触发 keydown/keyup 事件，事件对象携带 key（逻辑键名，如 a、Enter，受 Shift 和输入法影响）和 code（物理按键位置，如 KeyA，不受修饰键影响）。检测按键是否正常，就是监听这些事件并高亮对应的虚拟键。两个键盘硬件概念值得了解：「键位冲突/幽灵键（ghosting）」与「无冲（NKRO，N-Key Rollover）」——普通薄膜键盘同时按下多个键时，因矩阵扫描电路的限制会出现幽灵按键或某些组合无效；NKRO（全键无冲）键盘（多为机械键盘）能同时识别任意多个按键，对游戏和快速打字更友好。此外，Fn 键、系统级快捷键和部分媒体键由系统或键盘固件直接拦截，浏览器收不到事件，因此无法测试。
⚠️ 某些键（Fn、系统键、媒体键）测不到
这些键由系统或键盘固件拦截，浏览器收不到事件，属于正常现象。
⚠️ 同时按多个键时有键不响应
这是薄膜键盘的键位冲突（ghosting）；需 NKRO（全键无冲）键盘才能同时识别全部按键。
⚠️ Shift+字母时 key 值变了
key 受修饰键影响（Shift+a → A），而 code 始终是 KeyA，两者语义不同。
⚠️ 浏览器对按键没反应
先点击页面让按键监听获得焦点，或检查焦点是否被其他元素抢占。
参考与更新
最后更新：2026-06-29