键盘测试

按下任意按键即时高亮对应键帽,支持多键同按与逐键计数,信息面板显示 key、code、keyCode 与组合键。

让焦点停在本页,直接敲击键盘即可测试:键帽亮起表示事件正常到达,松开恢复原色。触屏设备可以直接点按键帽。

key-
code-
keyCode-
location-
修饰键组合-
总按压0
按住中0
已测键0

键帽为英文物理标识。两种语言页面保持一致,全部检测在浏览器本地完成,本站不记录、不上传任何按键内容。

使用说明

  1. 让本页保持焦点,直接敲击键盘:对应键帽亮起,键帽上累计按压次数,松开后高亮消失。
  2. 按住多颗键可以同时点亮多枚键帽,感受键盘无冲表现;薄膜键盘三四键以上丢键多为硬件限制。
  3. 信息面板显示 event.key、code、keyCode、location 与修饰键组合,排查快捷键时直接对照。
  4. 点「重置计数」清空全部键帽数字与统计,开始下一轮干净测试。
  5. 触屏设备点按键帽即可模拟按压,同样会计数并显示该键的代码。

常见问题

按了键但键帽没有反应怎么办?
先确认焦点在页面上,而不是浏览器地址栏。F5、Ctrl+T 这类组合会被浏览器优先处理,事件不会到达页面。部分输入法在候选状态会吞掉个别按键,切换到英文模式再测一次。Fn 键通常不产生系统事件,页面上没有它的键帽属于正常设计。
我按下的内容会被上传吗?
不会。页面监听按键事件只是为了更新键帽高亮与计数,所有数据都留在当前标签页里,不写入本地存储,也不发出任何网络请求。
可以多颗键一起按住吗?
可以。每一颗按住的键都会保持亮起,页面会同时显示当前全部按下的键。一次能正确识别几颗键取决于键盘硬件的无冲设计,与页面无关。
code 和 keyCode 有什么区别?
event.code 描述物理键位,不随输入法与键盘布局变化;event.key 是处理后的字符结果。keyCode 是保留给旧脚本的数字编号,已经停止演进,新项目优先使用 code。

使用步骤

  1. 敲击任意按键

    把焦点放在页面上后直接敲击键盘,对应键帽立即亮起,松开恢复原色,键帽上同时累计这颗键的按压次数。

  2. 测试多键同按

    按住多枚键不放可以同时点亮多枚键帽,用来感受无冲表现。薄膜键盘常见三四键丢键,机械键盘与全键无冲键盘表现更好。

  3. 查看按键详情

    信息面板记录最近一次按键的 key、code、keyCode、location 与修饰键组合。排查快捷键冲突或编写脚本时,可直接对照这里的数值。

  4. 重置计数

    需要重新统计时点「重置计数」,全部键帽的累计数字与三项统计一起归零,物理按键的按住状态不受影响。

  5. 触屏模拟

    手机与平板没有物理键盘时,点按键帽同样会计数、亮起并显示该键的代码,适合快速查询某个键位的 event.code。

工具详细介绍

键盘是最容易出问题的输入设备之一。液体泼溅、灰尘与长年重击都会让个别按键失灵,而日常打字很少覆盖全部键位,坏键往往要到真用的时候才发现。本页提供完整的 103 键布局,覆盖功能键排、主键区、编辑键区、方向键与数字小键盘。敲击任意按键,页面上对应的键帽会亮起并累计次数,逐个按一遍就能确认每颗键是否正常。新键盘开箱、二手键盘验收或清灰之后,都可以花几分钟做一次全键体检。

面板里的字段都是浏览器标准值。event.code 记录物理键位,不随输入法或键盘布局变化,按主键盘的 1 和小键盘的 1 会得到不同代码。event.key 是经过输入法处理后的字符结果。keyCode 则是早期网页使用的数字编号,如今已停止更新,但仍有旧脚本依赖。location 区分同一功能的键在键盘上的位置,左右两枚 Shift 分别标记为 1 和 2。所有检测都在浏览器里完成,本站不记录、不上传任何按键内容。

原理与背景

浏览器会把每一次敲击封装成 KeyboardEvent 事件派发给页面。keydown 在键帽按下的瞬间触发,keyup 在松开时触发,长按会按系统速率连续补发 keydown。页面用物理代码 event.code 匹配键帽,所以中文输入法在候选过程中也不影响高亮,按下即亮、松开即灭。高亮状态由脚本维护,同一时刻可以点亮任意多枚键帽,上限来自键盘硬件而不是页面。全键无冲的机械键盘可以十几个键互不干扰。多数薄膜键盘内部矩阵有限,四五个键同按就可能丢键或串键,选购无冲键盘时常以这项指标衡量。

keyCode 源自上世纪九十年代的浏览器实现,各家一度各自为政。后来它被统一进 DOM 规范并标记为废弃,但为了兼容旧网页至今仍然保留。event.code 由 W3C 的 UI Events 规范定义,命名跟随美式物理布局。字母区按 QWERTY 顺序排列,日文键盘上的假名键也会报告对应的 QWERTY 代码。location 用 0 到 3 区分标准区、左侧、右侧与数字小键盘。理解这三个字段的分工之后,排查快捷键失灵、编写按键脚本都会顺利许多。你能明确指出问题出在物理键位、字符产出还是兼容层,配置输入法也更有把握。

典型使用场景

  1. 新键盘验收

    开箱或退换货前把每一颗键都按一遍,对照键帽高亮与计数确认没有坏键、连击或无冲短板。整套流程只要几分钟,比安装驱动软件省事,也能留下一份可对照的记录。

  2. 排查按键失灵

    某个快捷键突然不响应时,先在这里按下对应的物理按键,观察键帽高亮与 event.code 是否正常。若高亮与代码都对,问题多半出在软件设置或输入法;若键帽毫无反应,再怀疑键盘硬件本身。

  3. 脚本与开发调试

    写自动化脚本、游戏按键映射或扩展快捷键时,用面板读取 event.code、keyCode 与 location。不必翻文档猜键名,也不用安装额外的开发工具。排查组合键失灵时,面板还能顺带确认修饰键的组合顺序。

使用技巧

  • 全键巡检时从 Esc 顺序按到右 Ctrl,边按边看键帽数字是否增长,两三分钟即可覆盖全部 103 颗键。
  • 怀疑某颗键失灵时,先重置计数再单测这颗键,避免历史次数造成误判。
  • 写宏或自动化脚本时,用面板里的 event.code 当键名依据,它比 key 更稳定,不受输入法影响。

注意事项

  • 浏览器快捷键

    F5 刷新、Ctrl+T 新建标签这类组合会被浏览器优先处理,按键不会到达页面。测试这类键请在浏览器设置里调整,或改用其他组合验证,键帽不亮不代表键盘故障。

  • 输入法拦截

    部分输入法在全角或候选状态下会吞掉个别按键事件,此时高亮不亮并不代表键盘坏了。先切换到英文模式再测一次,得到的结果更干净,也能排除输入法的干扰。

  • 无冲表现看硬件

    页面同时点亮多少键帽都没有问题,但薄膜键盘常见四键以上丢键,机械键盘也要看二极管方案。测出丢键先换 USB 口或换键盘对照,再决定是否退货。

相关工具