键盘测试器

概述

键盘测试器是一款在线按键检测工具,仅支持桌面端使用,通过虚拟键盘可视化展示每次按键的响应状态,帮助验证新键盘按键是否全部正常、排查特定按键失灵故障,以及熟悉不同配列的键位布局。

支持的键盘布局配列

工具内置从紧凑到全尺寸的多种主流机械键盘配列:数字小键盘(10%)、40%、40% 正交(ortho)、50%、50% 正交、60%、60% ISO、60% WKL(无 Windows 键)、60% HHKB、60% TSANGAN、65%、75%、80% TKL(无小键盘)、95%、100% 全尺寸。

选择与实体键盘匹配的配列后,页面渲染对应的虚拟键盘。按下实体键时,对应虚拟按键变为深灰色,松开后恢复原色,实时反映按键状态。

显示样式

Cherry 样式

  • 标准矩形键帽外观
  • 支持显示子字符(副刻)
  • 适合测试多层映射键盘

SA 样式

  • 球形键帽风格,字符居中显示
  • 不显示子字符
  • 适合展示圆润键帽布局外观

子字符(副刻)选项

Cherry 样式下可叠加显示键帽右下角的副刻标注,支持多种语言字符集:

  • :只显示主刻字符
  • Arabic / Cyrillic / Chinese / Greek / Hangul / Hebrew / Hiragana / Katakana / Devanagari / Czech:在对应语言的键位上叠加显示该语言字符

子字符显示适合多语言键盘用户确认双刻键帽的字符分布,或向他人演示键盘的语言适配情况。

按键检测说明

工具基于浏览器的 keydown / keyup 事件与标准 QMK 键码映射,覆盖大部分标准按键。以下情况会影响检测效果:

  • 在文本输入框、下拉框等可交互元素中按键时不触发测试,需先点击页面空白处
  • Ctrl+W(关闭标签页)、Alt+F4(关闭窗口)等系统级快捷键会被浏览器或操作系统优先处理,无法在工具中显示
  • 部分功能键(如媒体键、调音量键)的 QMK 键码可能与标准映射不一致

点击"全屏"按钮可全屏展示虚拟键盘,便于演示或近距离检查每个按键。所有按键事件仅用于页面内显示,不记录、不上传任何按键数据。