Linux Wayland环境下无需第三方守护进程修复失灵的右Shift键

问题背景 #

你新买了键盘后发现右Shift键失灵，排查后觉得是固件/软件层面的问题而非硬件故障。在X11环境下你能通过xmodmap -e "keycode 97 = Control_R"临时调整按键映射，但换到Wayland环境（试过GNOME和KDE）后，想找到不用第三方守护进程的靠谱修复方法。

从你给出的xev输出能明确核心问题：

• 按下A键时的输出：

KeyRelease event, serial 38, synthetic NO, window 0x2a00001,
root 0x397, subw 0x0, time 1329942, (158,-25), root:(2128,94),
state 0x10, keycode 38 (keysym 0x61, a), same_screen YES,
XLookupString gives 1 bytes: (61) "a"
XFilterEvent returns: False

• 按下右Shift键时的输出：

KeyRelease event, serial 38, synthetic NO, window 0x2a00001,
root 0x397, subw 0x0, time 1459660, (158,-25), root:(2128,94),
state 0x10, keycode 97 (keysym 0x0, NoSymbol), same_screen YES,
XLookupString gives 0 bytes:
XFilterEvent returns: False

简单来说，系统能捕获到右Shift的按键事件（keycode 97），但没把它和右Shift的功能关联起来。

修复方案（完全无需第三方守护进程） #

1. GNOME桌面（Wayland）

GNOME在Wayland下有原生的按键映射配置方式，两种途径可选：

• 图形化操作（直观简单）：
  1. 打开系统「设置」→进入「键盘」面板→拉到最底部点击「查看及自定义快捷键」
  2. 点击页面右上角的齿轮图标，选择「键盘映射」
  3. 在弹出的映射表中找到keycode 97，将其对应的功能改为「Right Shift」，保存后即可生效，无需重启会话。
• 命令行方式（适合批量/远程操作）：
  用gsettings直接修改系统配置，执行以下命令：

  gsettings set org.gnome.desktop.input-sources xkb-options "['keycode:97=shift_r']"
  

  执行后重启GNOME会话就能看到效果，后续可以用gsettings get org.gnome.desktop.input-sources xkb-options验证配置是否生效。

2. KDE Plasma桌面（Wayland）

KDE Plasma同样支持原生的按键映射配置，两种方法：

• 图形化操作：
  1. 打开「系统设置」→进入「输入设备」→「键盘」→切换到「高级」选项卡
  2. 勾选「配置键盘选项」，找到「按键重映射」分类，点击「添加自定义映射」
  3. 在弹出的窗口中，按下你的右Shift键（会自动识别keycode 97），然后在下拉菜单中选择「Right Shift」，应用设置后立即生效。
• 命令行方式：
  用kwriteconfig5修改KDE的键盘配置文件：

  kwriteconfig5 --file kxkbrc --group Layout --key "KeyMap" "keycode 97 = Shift_R"
  

  执行后重启Plasma会话即可完成配置。

3. 通用Wayland方案（适配所有桌面）

如果上述桌面专属方法不适用，还可以通过系统级的libinput配置来解决，这是Wayland通用的底层方案：

1. 先通过lsusb或者evtest工具找到你的键盘硬件ID（比如b3v1234p5678e0100这类格式，对应总线ID、厂商ID、产品ID、版本ID）
2. 创建一个udev硬件数据库文件：sudo touch /etc/udev/hwdb.d/90-custom-keyboard.hwdb
3. 编辑该文件，添加以下内容（把<YOUR_KEYBOARD_HW_ID>替换成你实际的硬件ID，keycode97转十六进制是0x61，所以对应KEYBOARD_KEY_61）：

   evdev:input:<YOUR_KEYBOARD_HW_ID>*
     KEYBOARD_KEY_61=shift_r
   

4. 重新加载硬件数据库并触发udev规则：

   sudo systemd-hwdb update
   sudo udevadm trigger
   

   操作完成后，所有Wayland桌面都会把这个按键识别为右Shift，无需额外守护进程。

额外建议 #

如果尝试完上述方法还是有问题，大概率是键盘固件的问题，建议联系键盘厂商索要Linux下的固件更新工具，很多外设厂商现在都提供Linux兼容的固件升级程序。

备注：内容来源于stack exchange，提问作者disp0