GoJS 3.0.0版本中的键盘布局兼容性问题解析

问题背景

在GoJS 3.0.0版本中，用户报告了一个关于节点复制功能在俄语键盘布局下无法正常工作的问题。这个问题特别出现在Windows系统上，而在Mac系统上则表现正常。

问题根源

问题的根本原因在于GoJS 3.0.0版本对InputEvent.key属性的处理方式发生了变化。在Windows系统上使用俄语键盘布局时，当用户按下Ctrl+C或Ctrl+V组合键时，系统返回的.key值是基于当前键盘布局的俄语字符(如"с"和"м")，而不是标准的"C"和"V"。

相比之下，在Mac系统上，即使使用非英语键盘布局，.key属性也会始终返回基于QWERTY布局的英文字符。这种平台差异导致了Windows用户在非英语键盘布局下无法正常使用复制粘贴功能。

临时解决方案

在官方修复发布前，用户可以通过创建自定义CommandHandler类来临时解决这个问题。该方案通过以下方式实现：

1. 检测操作系统类型(是否为Mac)
2. 重写doKeyDown方法
3. 使用event.code属性而非event.key属性来判断按键
4. 根据操作系统类型选择正确的修饰键(Command或Ctrl)

这种方法绕过了键盘布局差异问题，因为event.code属性始终返回物理按键的位置信息，而不受当前键盘布局影响。

官方修复

GoJS团队在3.0.1版本中修复了这个问题。修复后的版本能够正确处理不同键盘布局下的快捷键输入，确保了跨平台和跨语言环境下的功能一致性。

深入理解

这个问题揭示了Web开发中处理键盘输入时需要考虑的几个重要方面：

1. 键盘事件属性差异：不同浏览器和操作系统对键盘事件属性的处理存在差异
2. 物理按键与字符映射：event.code代表物理按键位置，event.key代表实际生成的字符
3. 平台特定的修饰键：Mac使用Command键，而Windows使用Ctrl键作为主要修饰键

最佳实践建议

对于需要处理键盘输入的Web应用开发，建议：

1. 同时考虑event.code和event.key属性
2. 为不同平台提供适当的键盘快捷键提示
3. 进行跨平台和跨语言环境的充分测试
4. 考虑提供可自定义的快捷键配置

这个问题及其解决方案不仅适用于GoJS库，也为其他需要处理复杂键盘交互的Web应用提供了有价值的参考。