外接键盘按键映射失效：~/.Xmodmap配置不生效求助

这个问题我之前帮朋友排查过，大概率是Xmodmap的生效逻辑或外接设备的键码差异导致的，咱们一步步来解决：

1. 先确认加载时机问题 #

Xmodmap默认只会在X服务器启动时加载一次，之后接入的外接键盘不会自动应用已有的映射规则。你可以先做个简单测试：

• 接入外接键盘后，在终端手动运行 xmodmap ~/.Xmodmap，如果此时映射生效了，那就是加载时机的问题。
• 要实现自动加载，可以写个udev规则：创建 /etc/udev/rules.d/99-keyboard-map.rules 文件，内容如下（替换成你的外接键盘名称和用户名）：

  SUBSYSTEM=="input", ATTRS{name}=="你的外接键盘名称", RUN+="/usr/bin/xmodmap /home/你的用户名/.Xmodmap"
  

  然后重启udev服务生效：sudo udevadm control --reload-rules

2. 检查外接键盘的键码是否和内置键盘一致 #

不同品牌的键盘，同一按键的键码可能不一样，Xmodmap是基于键码生效的，键码不匹配规则自然失效：

• 先查外接键盘的设备ID：运行 xinput list，找到你的外接键盘条目，记下它的ID（比如12）。
• 测试键码：运行 xinput test 你的设备ID，然后分别按Home、PageUp、End、PageDown键，终端会输出对应的键码（比如key press 110）。
• 修改Xmodmap规则：如果键码和内置键盘不同，就针对外接键盘的键码补充映射。比如外接键盘Home键码是110、PageUp是112，就把下面内容加到~/.Xmodmap里：

  keycode 110 = Prior NoSymbol Prior
  keycode 112 = Home NoSymbol Home
  keycode 115 = Next NoSymbol Next
  keycode 117 = End NoSymbol End
  

  （注：Xmodmap里用Prior指代PageUp，Next指代PageDown）

3. 排查桌面环境的设置冲突 #

很多桌面环境（GNOME、KDE、XFCE等）自带键盘映射工具，优先级比Xmodmap高，会覆盖你的规则：

• 打开桌面环境的「键盘设置」，查看是否有自定义按键映射或「导航键」相关配置，确保没有和你的Xmodmap规则冲突。
• 如果是GNOME这类环境，其实直接用系统自带的键盘设置来添加映射，反而比Xmodmap更稳定。

4. 改用更现代的XKB配置替代Xmodmap #

Xmodmap是比较老旧的工具，XKB（X Keyboard Extension）更灵活，能更好地处理多设备场景：

• 在/usr/share/X11/xkb/symbols/下创建自定义文件mykeys，内容如下：

  partial alphanumeric_keys
  xkb_symbols "swap_home_pgup" {
      key <HOME> { [ Prior, Prior ] };
      key <PGUP> { [ Home, Home ] };
      key <END>  { [ Next, Next ] };
      key <PGDN> { [ End, End ] };
  };
  

• 终端运行 setxkbmap -option mykeys:swap_home_pgup 测试生效，之后把这个命令加到你的登录启动脚本里即可。

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