本文详解virtualbox `ikeyboard.putscancodes()` 接口使用的**物理键盘扫描码（scan code）**机制，阐明其与java/windows中虚拟键码（vk_p = 0x50）的本质区别，并提供可运行的编码转换方案与实用建议。
在使用 VirtualBox Java SDK 控制虚拟机键盘输入时（如调用 k.putScancodes(Arrays.asList(25, 25 | 0x80)) 发送字母 P），开发者常困惑于：为何 Java 的 KeyEvent.VK_P 和 Windows 文档中的虚拟键码均为 0x50（即 ASCII 码值），而 VirtualBox 却要求传入 25？答案在于——VirtualBox 的 IKeyboard 接口不接受虚拟键码（Virtual Key Code），而是直接模拟物理键盘行为，接收的是底层硬件级的扫描码（Scan Code）。
扫描码 vs 虚拟键码：根本差异
-
扫描码（Scan Code）：由物理键盘芯片生成，表示“某个物理按键被按下/释放”，与字符无关，且依赖键盘布局和历史标准（如 IBM PC/XT 的 Scan Code Set 1）。例如：
- 25 表示 P 键按下（make code）；
- 25 | 0x80 = 153（即 0x99）表示 P 键释放（break code）。
- 虚拟键码（Virtual Key Code）：是操作系统抽象层定义的逻辑常量（如 VK_P = 0x50），用于统一处理不同键盘布局下的语义操作（如“用户想输入字母 P”），需由键盘驱动将扫描码翻译而来。
VirtualBox 为保证跨平台兼容性与精确硬件仿真，选择绕过宿主机 OS 的键盘驱动栈，直接向客户机注入原始扫描码——这正是 putScancodes() 接口的设计定位：低阶、无状态、与 BIOS/UEFI 引导阶段兼容。
实际编码：使用 Scan Code Set 1（VirtualBox 默认）
VirtualBox 使用的是经典的 IBM PC/XT Scan Code Set 1（也称 “AT Set” 或 “Set 1″）。以下是常用字符对应关系（含 Shift 修饰）：
| 字符 | 按下扫描码 | 释放扫描码 | 备注 |
|---|---|---|---|
| P | 25 | 153 | 25 \| 0x80 |
| 2 | 3 | 131 | 主键盘区数字键 |
| b | 48 | 176 | 小写 b（需配合左 Shift） |
| Shift（左） | 42 | 170 | 必须先按再松，才能生效 |
✅ 正确发送小写字母 p 的完整流程（含 Shift 控制）：
