FarManager在AZERTY键盘布局下的宏快捷键识别问题分析

项目背景
FarManager作为一款经典的文件管理器，其宏功能在自动化操作中扮演着重要角色。近期在3.0.6300.0 x64版本中，使用法语AZERTY键盘布局的用户反馈存在特殊字符键位识别异常问题，特别是在远程桌面环境下表现更为突出。

问题现象

1. 核心冲突
   在AZERTY布局中位于Esc键下方的²（U+00B2）字符键与单引号'（U+0027）键产生识别混淆：

   • 用户尝试将²键设置为宏快捷键时，系统错误识别为'键
   • 最终导致两个键位都会触发同一宏命令
   • 严重影响命令行场景的单引号输入

2. 扩展问题

   • 宏录制触发组合键从传统的Ctrl+.变为Ctrl+:
   • 远程桌面环境下出现键盘布局自动切换为QWERTY的异常情况
   • CapsLock状态同步失效等连带问题

技术原理分析

1. 键盘扫描码映射机制
   FarManager对VK_OEM_*虚拟键码采用美国键盘布局作为基准映射，这种设计虽然保证了多键盘布局下的操作一致性，但在非QWERTY布局下会导致物理键位与功能映射不匹配。

2. 远程桌面特殊处理
   远程会话中的键盘布局识别存在双重映射：

   • 本地客户端实际按键布局
   • 远程服务器接收的布局信息 当两者不一致时，系统会优先采用服务器端布局解释键位，这是产生²/'混淆的根本原因。

解决方案演进

1. 版本迭代修复
   开发团队在3.0.6359版本中针对AZERTY布局优化了特殊字符处理逻辑，重点修复了²键的识别问题。

2. 用户应对建议

   • 优先升级到最新稳定版本
   • 本地环境测试确认基础功能正常
   • 远程桌面环境下建议：
     • 保持两端键盘布局一致
     • 检查远程会话的键盘布局设置
     • 避免使用系统级快捷键冲突

深度技术建议
对于需要开发跨键盘布局兼容工具的技术人员，建议：

1. 采用WH_KEYBOARD_LL低级钩子获取原始输入事件
2. 配合GetKeyboardState获取当前布局状态
3. 实现布局自适应的虚拟键码转换层

总结
该案例典型展示了国际化软件在特殊键盘布局下面临的输入处理挑战。FarManager团队通过持续优化键盘事件处理流水线，逐步完善了对非标准布局的支持。用户在复杂环境（如远程桌面）中使用时，应当注意系统级输入设置的同步性，必要时可通过自定义键位映射解决特定场景的兼容性问题。