能否动态获取键盘按键的相邻键及对应布局？

Great question! The short answer is: there’s no universal, cross-platform system API that can dynamically retrieve the physical adjacent keys of a given key directly from the system—but there are practical workarounds depending on your needs.

为什么没有通用的动态获取方式？ #

操作系统（Windows、macOS、Linux等）只会追踪按键扫描码和字符映射关系，并不会存储按键之间的物理空间位置关联这类元数据。键盘布局（QWERTY、AZERTY、Dvorak或是用户自定义布局）是视觉/物理层面的设计，并非系统会主动暴露的结构化数据。哪怕你能拿到某个按键的扫描码，也没有内置的机制能直接查询到它的相邻键。

可行的解决方案 #

1. 预定义主流布局的映射表 #

这是最常用的方案。你可以手动为常见键盘布局创建字典或查找表，把每个按键对应的相邻键提前存好。比如针对QWERTY布局：

qwerty_neighbors = {
    'G': ['R', 'T', 'Y', 'F', 'H', 'V', 'B'],
    'A': ['Q', 'W', 'S', 'Z'],
    # 补充其他所有按键的映射关系
}

优点：实现简单，能覆盖绝大多数普通用户的需求。
缺点：如果用户使用非标准或自定义布局，就会失效。

2. 用户校准流程 #

如果需要支持自定义或小众布局，可以设计一个快速校准步骤：引导用户依次按下目标按键的相邻键（或部分核心按键的相邻键），然后记录下对应的关联关系。比如：

"为了启用相邻键检测，请依次按下G键的正上方、正下方、左侧、右侧，以及四个斜向相邻的按键。"
这种方式能得到完全适配用户实际键盘的布局映射。

3. 特定场景的特殊处理 #

• 桌面应用：部分键盘硬件可能会暴露原始位置数据，但这高度依赖厂商，跨设备的可靠性极低。
• 网页应用：浏览器不会提供任何获取键盘物理位置的API，只能依赖前面两种方案。

额外注意事项 #

• 键盘尺寸影响：笔记本键盘、全尺寸机械键盘、紧凑型布局（比如60%配列）的相邻键关系可能不同（比如部分紧凑键盘会省略某些按键）。
• 自定义按键映射：哪怕用户用的是QWERTY布局，也可能通过系统设置或第三方工具修改了按键映射——除非结合扫描码校验，否则预定义的映射表无法适配这种情况。

内容的提问来源于stack exchange，提问作者Pavel Voronin