键盘检测工具的功能与应用场景
键盘测试（Keyboard Test）是一款免费的在线工具，旨在帮助用户检测键盘的物理功能，并检查每个按键按下时所生成的底层技术事件代码。用户只需在页面的任意位置按下按键，工具便能立即检测按键是否正常响应，并在可视化的键盘布局图上直观标记已测试的按键。此外，该工具还能追踪当前按住的按键，并记录详细的、可随时清除的事件日志。
通过这些实时反馈，用户可以轻松区分正常的硬件行为（例如系统的按键自动重复）与实际的硬件故障（如按键无响应或开关双击）。
该工具主要适用于以下群体和场景：
- 硬件故障排查：用户若怀疑键盘存在硬件缺陷，可以使用此工具诊断死键、磨损的开关，或单次敲击却触发多次输入的“双击”问题。
- 网页与游戏开发：程序员可以利用此工具，直观地验证不同物理按键、键盘布局及修饰键在现代浏览器中映射为 JavaScript 事件属性（如
key、code和废弃的keyCode）的具体数值。 - 移动设备测试：用户可以检测虚拟键盘、屏幕键盘或通过蓝牙连接的外接键盘在移动操作系统上的输入表现与事件报告情况。
- 键盘客制化：键盘爱好者在组装、重映射或改装键盘后，可使用此工具确保每个开关在预期的布局位置上均能正常触发。
输入源与操作方式
本工具支持多种输入方式，以适应不同的测试需求：
- 物理按键输入：在页面的任意位置按下键盘上的任意键，工具都会自动捕获输入。
- 全捕获模式：直接点击屏幕上的键盘布局图，即可激活针对特定按键（如空格键 Space、制表键 Tab 以及各类功能键）的聚焦捕获。在此模式下，这些按键不会触发浏览器的默认页面行为。按下 Esc 键即可退出该模式并释放键盘。
- 屏幕键盘输入：针对移动设备或虚拟键盘，用户可以在专用的移动端输入框中进行输入测试。
- 清除日志指令：点击“清除日志”按钮，可手动一键清空已记录的全部事件历史。
实时输出数据详解
当您按下按键时，工具会实时输出以下多维度的数据与状态：
1. 最新按键事件
此区域展示最近一次按键操作的详细属性：
- 按键（Key）
- 代码（Code）
- 废弃 keyCode（Legacy keyCode）
- 位置（Location）：显示为“标准”、“左侧”、“右侧”或“数字键盘”。
- 修饰键（Modifiers）：若无激活的修饰键则显示“None”；若有，则显示当前处于激活状态的修饰键，包括“Shift”、“Ctrl”、“Alt”、“Meta”和“Caps Lock”。
- 按下/弹起状态徽章与**重复 ×
{count}**徽章：当按住某个按键时，该徽章会累计并显示系统自动重复事件的次数。
2. 键盘布局图
一个基于标准 ANSI 布局的可视化键盘图，根据按键的实时状态高亮显示：
- 当前按下（Held）
- 已测试（Tested）
3. 统计数据
- 已测试按键
- 总按压次数
- 当前按住
4. 事件日志
一个以表格形式呈现的历史记录，表头为“事件日志”（若无记录则显示“暂无按键事件 — 请按任意键。”）。表格包含以下列：
- 时间
- 事件（显示为“按下”或“弹起”）
- 按键
- 代码
- 修饰键
注：按住按键时触发的自动重复事件仅会在最新按键事件的“重复”徽章中累加，不会作为新条目写入事件日志中。
5. 捕获状态指示器
显示当前的键盘捕获状态，包括：
- “按任意键开始”
- “正在捕获按键输入”
- “全捕获模式 — 按 Esc 键释放键盘”
6. 屏幕键盘测试
专为移动端设计的测试区域，包含：
- 带有“点击并输入...”占位符的文本输入框。
- 提示信息：“点击该输入框并输入内容 — 浏览器报告的任何内容都会显示在上方。”
运行规则与边界情况
在测试过程中，了解以下技术规则有助于准确判断键盘状态：
| 规则维度 | 详细说明 |
|---|---|
| 系统与浏览器快捷键 | 浏览器或操作系统预留的快捷键（如切换标签页、关闭窗口、全屏模式或系统搜索）会在到达网页前被系统拦截。工具无法捕获这些组合键，用户需要单独测试其中的各个物理按键以验证其硬件功能。 |
| 按键值（Key）与代码值（Code） | “按键”值是动态的，会根据当前激活的修饰键和系统语言布局而改变（例如，按下同一个物理键可能会输出 “a” 或 “A”）。而“代码”值代表该键在键盘上的物理位置（如 “KeyA”、“ShiftLeft”、“Space”），是静态且永远不会改变的。 |
| 自动重复行为 | 持续按住一个按键会触发操作系统的连续按下事件，工具会通过“重复”徽章和计数器来展示这一状态。 |
| 移动端与虚拟键盘 | 虚拟键盘（尤其是 Android 系统）通常会发送不带具体按键值的通用事件，导致读数显示为 “Unidentified”。用户必须使用专用的“屏幕键盘测试”输入框来捕获移动端浏览器报告的实际内容。 |
| 布局限制 | 页面上的键盘图采用固定的标准 ANSI 布局。未在该图上标出的按键（如 ISO 布局特有按键、笔记本电脑的 Fn 键层、媒体控制键）在按下时不会在键盘图上亮起，但其数据仍会正常注册并显示在最新事件读数和事件日志中。 |
| 数据即时销毁 | 点击“清除日志”按钮，或者刷新、离开当前页面，都会永久抹除所有已捕获的事件数据。 |
隐私与数据处理说明
本工具高度重视用户的数据隐私。所有按键输入均在用户的浏览器本地进行处理，且仅由当前活动的网页读取，用于生成屏幕上的事件读数和日志。任何按键数据都不会被存储，也不会上传至外部服务器。一旦用户清除日志或离开页面，所有的活动记录都将被立即且彻底地抹除。
常见问题解答
为什么有些组合键没有显示？
浏览器或操作系统保留的快捷键（例如关闭或切换标签页和应用、全屏、系统搜索）在页面看到它们之前就被拦截了，因此它们永远不会出现在这里。这种无响应是正常的，并不代表按键损坏：您可以逐个测试这些按键，它们都会单独被识别。
key 值和 code 值有什么区别？
key 值是当前按键产生的字符或操作——它会随着您的键盘布局和修饰键而改变，因此同一个物理按键可能会报告 “a” 或 “A”，或者在其他语言布局上报告完全不同的字母。code 值代表物理位置（如 KeyA、ShiftLeft、Space）且永远不会改变，这就是为什么游戏和应用程序会将快捷键绑定到 code 的原因。
按住按键时它会一直触发，这是坏了吗？
不是。按住一个键会让系统发送重复的按下事件，在此处会显示 Repeat 徽章和计数器——这是正常的自动重复。真正的故障迹象是相反的情况：单次快速敲击产生多个事件，或者敲击后完全没有反应，这表明按键开关已磨损或卡住。
为什么我的手机键盘显示 “Unidentified”？
屏幕键盘（尤其是 Android 系统上）经常发送不带真实 key 值的通用事件，而页面只能显示浏览器报告的内容。您可以打开布局下方的屏幕键盘测试，查看您的键盘实际发送了什么；外接键盘或笔记本电脑键盘则会报告完整的详细信息。