Ubuntu/Linux 把 Caps、Super、Ctrl 或 Tab 映射为 Esc：Wayland、X11 与 Fn 边界

把另一个键设为 Esc 之前，先确定要改变哪一层：单个应用、当前 GNOME 用户、X11 会话、某个输入设备、Linux 虚拟控制台，还是整台机器。范围越大，密码输入、屏幕锁定、无障碍导航和恢复的风险越高。最安全的默认方案是保留物理 Esc，先在普通用户会话中测试一个额外的 Esc，确认回退后才考虑持久化。

1. 先选择最窄的作用域

需求 优先层 不应先做的事
只在 Vim 中更容易退出插入模式 应用内置键或应用配置 改整台机器的键盘
Caps Lock 作为额外 Esc GNOME 用户级 XKB 标准选项 交换 Esc/Caps 或覆盖现有 XKB 选项
某把键盘的右 Ctrl、Super 或 Tab 作为 Esc input-remapper 的单设备、单预设测试 一次改所有键盘并启用自动加载
只处理 X11 旧应用 X11/XKB 会话配置 假定 xmodmap 能控制原生 Wayland 应用
Linux 文本控制台或登录屏幕 管理员维护的 console/systemd 配置 在没有第二输入路径时全局修改
Fn 不产生独立事件 键盘固件/厂商设置 猜 keycode 或把组合键事件称为 Fn

不要同时映射 Caps、Super、Ctrl 和 Tab。一次只测试一个候选键，并保留另一侧 Ctrl、Tab、Super、物理 Esc 或第二把键盘作为恢复路径。

2. 这些键原本都有重要职责

  • Caps Lock：通常是风险最低的候选，但 Orca 的笔记本布局默认可把 Caps Lock 用作 Orca modifier；需要大小写锁定或屏幕阅读器时必须先确认。
  • Super/Win：GNOME 用它打开 Activities；Super+Space 还常用于切换输入源。映射后会改变桌面导航。
  • Ctrl：终端、编辑器、浏览器和无障碍功能大量依赖它。若必须测试，只考虑单独的右 Ctrl，并保留左 Ctrl。
  • Tab：GNOME 无障碍文档把 Tab 和 Ctrl+Tab 用于移动键盘焦点。依赖键盘导航、表单或屏幕阅读器时不要夺走 Tab。
  • Fn：多数笔记本在键盘控制器/固件中处理 Fn，Linux 可能只看到 Fn 组合后的亮度、音量或功能键事件，甚至看不到单独 Fn。

在密码框中，字符通常不可见；错误范围的映射可能直到锁屏、sudo、磁盘解锁或远程控制台才暴露。测试时不要输入真实密码。

3. 变更前建立恢复路径

在任何持久化操作前：

  • 保留物理 Esc，不要先做交换映射。
  • 接好并测试第二把键盘，或确认触摸屏键盘、受控远程会话/TTY 能登录；远程方案不能依赖将被改坏的同一输入栈。
  • 关闭正在捕获原始按键的工具后再输入密码。
  • 记录当前会话类型、输入源、XKB options、console keymap、辅助技术和 input-remapper 自动加载状态。
  • 对用户配置做只读备份；系统级配置还需要管理员、维护窗口和控制台回退。

不要把“注销后会恢复”当成保证：GNOME gsettings、input-remapper autoload、console keymap 和 hwdb 都可能跨登录或重启持续生效。

4. 只读清点 Wayland、X11 与配置来源

先运行以下命令。某些命令在非 GNOME、非 X11 或缺少对应软件时会失败；记录失败，不要把空输出解释为默认值。

echo "$XDG_SESSION_TYPE"
echo "$XDG_CURRENT_DESKTOP"
loginctl show-session "$XDG_SESSION_ID" -p Type -p Remote
gsettings writable org.gnome.desktop.input-sources xkb-options
gsettings get org.gnome.desktop.input-sources xkb-options
localectl status
localectl list-x11-keymap-options | grep -E '^caps:(escape|swapescape|escape_shifted_capslock)$'
command -v xev setxkbmap xmodmap libinput input-remapper-control
setxkbmap -query
xmodmap -pm
systemctl status input-remapper --no-pager

$XDG_SESSION_TYPE=wayland 时，setxkbmap、xmodmap 和 xev 最多反映 Xwayland 边界，不能证明原生 Wayland 应用采用相同映射。GNOME 用户级 xkb-options 由桌面会话应用；仍应分别测试原生 Wayland、Xwayland 和锁屏。

localectl 展示系统的 console/X11 默认值，不等于当前 GNOME 用户的最终组合。不要用 localectl set-keymap 或 set-x11-keymap 覆盖机器设置来解决个人 Vim 习惯。

5. 先证明系统是否看到了目标键

Linux 输入子系统只有收到 EV_KEY 等事件，用户空间工具才有东西可映射。先列出设备，再在专用测试窗口中只按目标键和 Esc：

libinput list-devices
grep -E 'Name=|Handlers=|EV=' /proc/bus/input/devices

X11 会话可在一个小窗口中观察：

xev -event keyboard

Wayland/底层诊断可依据 libinput 文档运行 libinput debug-events --show-keycodes；它通常需要读取受保护的 input 设备。该工具会看到原始按键：暂停聊天、密码管理器和登录操作，只按测试键，立即退出，不共享包含私密输入的完整日志。不要使用 grab 模式锁住唯一键盘。

keycode 不是跨键盘、协议、会话或工具的永久 ID。2014 年原文中的 9、115、151 只是当时特定 X11 环境的观察值，不能作为现代配置常量。

6. Fn 的硬件/固件边界

按下 Fn 本身时，若 kernel/libinput/input-remapper 都没有出现独立事件，就没有可由 XKB 或用户空间重映射的“Fn 键”。某些设备把 Fn+另一个键变成 KEY_BRIGHTNESSUP、KEY_VOLUMEUP、XF86WakeUp 或普通 F 键；那是组合结果，不是独立 Fn。

此时应查看键盘/笔记本厂商的固件设置、Fn Lock 或官方工具。不要根据 XF86WakeUp 猜它就是 Fn，也不要改 ACPI、内核驱动或 hwdb 来制造未经硬件证实的映射。若厂商不暴露事件，软件不能可靠捕获它。

7. 先考虑不改系统的应用内替代

Vim 官方帮助把 Ctrl-[ 列为与 Esc 等价的插入模式命令。这不修改键盘映射，不影响密码、桌面、Tab 导航或其他应用，适合先试。

其他编辑器、终端复用器和 IDE 可能提供自己的快捷键设置。优先用应用自带界面，并检查冲突、宏、插件及远程应用边界。不要假定 Vim 的 Ctrl-[ 语义适用于每个程序，也不要把容易出现在普通文本中的字母序列全局映射成 Esc。

8. GNOME：安全地让 Caps Lock 成为额外 Esc

当前 xkeyboard-config 提供 caps:escape，含义是让 Caps Lock 成为额外的 Esc；原 Esc 保留。这比 caps:swapescape 更容易恢复，也减少失去 Esc 的风险。

下面的脚本只在当前 XKB options 为空时继续，避免覆盖 Compose、布局切换或其他现有选项。它保存原始 GVariant 值，拒绝覆盖备份，并立即回读结果。

CurrentOptions="$(gsettings get org.gnome.desktop.input-sources xkb-options)"
BackupPath="gnome-xkb-options-$(date +%Y%m%d-%H%M%S).txt"
umask 077
test ! -e "$BackupPath" || exit 1
echo "$CurrentOptions" | tee "$BackupPath"
case "$CurrentOptions" in
  "@as []"|"[]") ;;
  *) echo "Stop: merge existing XKB options deliberately"; exit 1 ;;
esac
gsettings set org.gnome.desktop.input-sources xkb-options "['caps:escape']"
gsettings get org.gnome.desktop.input-sources xkb-options

若已有 options，停止并通过 GNOME 的键盘设置或经过审阅的 GVariant 列表合并；不要复制命令覆盖整个数组。先在普通编辑器、终端、原生 Wayland/Xwayland 应用中测试 Caps 和物理 Esc，不要立刻锁屏。

若需要保留 Caps Lock 功能，可先确认本机列出 caps:escape_shifted_capslock，再阅读当前 xkeyboard-config 描述并单独评估；不要假定所有发行版版本都提供相同 option。

9. 恢复 GNOME XKB options

在同一 shell 中可使用刚才的 $BackupPath。若已打开新 shell，把占位值换成实际、受信任的备份文件路径：

BackupPath="PASTE_THE_BACKUP_PATH"
test -r "$BackupPath" || exit 1
SavedOptions="$(cat "$BackupPath")"
gsettings set org.gnome.desktop.input-sources xkb-options "$SavedOptions"
gsettings get org.gnome.desktop.input-sources xkb-options

确认回读值与备份完全一致，再测试 Caps、Esc、Compose、输入源切换和既有快捷键。不要用 gsettings reset 代替恢复未知的旧列表，因为 reset 只回到 schema 默认值，不一定是用户原值。

10. Super、右 Ctrl 或 Tab：用 input-remapper 做单设备测试

标准 XKB option 未必提供想要的任意映射。input-remapper 项目说明它通过虚拟输入支持 X11 与 Wayland，并按设备/预设记录映射。它需要访问 /dev/input 和注入事件，权限与影响范围高于普通应用设置。

只从发行版官方包或项目正式 release 安装，并先阅读与你安装版本对应的 Usage。推荐顺序：

  1. 打开 GUI，选择明确的那一把键盘，创建新预设。
  2. 只录制一个候选键，把输出选为 GUI 自动补全提供的 Escape/对应名称；不要手填旧 keycode。
  3. 点击 Apply 临时注入，但不要启用 Autoload。
  4. 保留物理 Esc；若测试右 Ctrl，保留左 Ctrl。依赖键盘导航时不测试 Tab。
  5. 在普通文本、桌面快捷键和需要的应用中测试按下与释放；不要输入密码或锁屏。
  6. 用 GUI 的 Stop 停止注入，确认原键恢复，再决定是否持久化。

只读查看版本、设备、可用符号和服务状态：

input-remapper-control --help
input-remapper-control --list-devices
input-remapper-control --symbol-names | grep -Ei 'esc|escape'
systemctl status input-remapper --no-pager

项目文档警告 debug 日志可能包含私密输入，且错误 autoload 可能使设备无法使用。若发生卡键或设备失效，先用 GUI Stop；项目还给出拔插设备两次以停止注入的恢复建议。没有第二输入路径时不要启用 autoload。

11. X11 的 xmodmap 是旧式、会话局部方案

xmodmap 修改 X11 modifier/keymap，原生 Wayland 客户端不受它控制；在 Xwayland 混合会话中会出现应用间不一致。它还容易在把 Ctrl、Super 或 Caps 从 modifier 中移除时留下粘滞或丢失的 modifier 状态。

不要复制历史 keycode。若维护旧 X11 环境，先保存 xmodmap -pke 与 xmodmap -pm 输出，在隔离测试会话中根据当次 xev 证据修改，并准备从另一个终端结束该 X 会话。现代 GNOME 优先使用标准 XKB option；任意单设备映射优先用可停止的 input-remapper 预设。

12. Console、登录屏幕与 systemd hwdb 是系统级变更

Linux 虚拟控制台 keymap 与 GNOME 用户会话分离。localectl 设置 console/X11 系统默认值，可能影响 TTY 登录与密码输入。systemd 的 keyboard hwdb 可在设备事件进入桌面前按硬件匹配和扫描码重写 KEYBOARD_KEY_，因此能跨 Wayland/X11/用户生效，也更容易造成整机锁定。

这两类方案只适合管理员管理的固定设备：必须有精确硬件 match、原始扫描码证据、配置备份、第二键盘、物理/带外控制台、维护窗口和逐步部署。不要为了个人 Esc 偏好给所有键盘写宽泛 hwdb 规则，也不要修改 /usr/lib 中供应商文件；libxkbcommon 同样警告系统 XKB root 会在更新时被覆盖。

登录屏幕由显示管理器/系统设置控制，不能从“登录后的 GNOME 映射正常”推定密码登录安全。需要登录屏幕或 kiosk 级映射时，交给系统管理员并先在非生产机器验证。

13. 验证矩阵

检查点 预期证据 失败时动作
原物理 Esc 仍能关闭菜单/对话框并退出 Vim 插入模式 立即回退，不锁屏
新增 Esc 候选键按下/释放各产生一次 Esc，无重复或粘滞 Stop/恢复 XKB，检查事件
原键职责 Super overview、左 Ctrl、Tab 导航等保留预定路径 缩小作用域或换 Caps
Wayland 与 Xwayland 两类应用结果符合计划 不用 xmodmap 补丁叠加
无障碍 Orca modifier、Tab 焦点、屏幕键盘仍可用 先恢复，再由使用者评估
输入源/Compose 切换和 Compose options 未被覆盖 从备份恢复完整数组
屏幕锁定/登录 仅在有第二输入与回退时测试 无回退则停止持久化
重插/重启 只有批准的映射持久化 禁用 autoload 或恢复配置

每次只改变一个变量。测试按下、长按、重复和释放，避免只验证“按一下能出 Esc”。

14. 密码、隐私与无障碍边界

  • 原始事件工具和 input-remapper debug 能记录所有按键；运行期间不要输入密码、聊天或恢复码。
  • 不把 /dev/input 权限开放给所有用户，也不长期以 root 运行未知脚本。
  • Caps Lock 可能是 Orca modifier；Tab 是键盘焦点导航；Super 与 Ctrl 承载桌面和应用快捷键。
  • 单用户 GNOME 映射不应被描述为 console、显示管理器、容器、远程桌面或所有应用的全局保证。
  • 修改后的键帽与实际行为不同；共享、公共或无障碍设备应贴标签并记录回退。

如果这是职业健康或无障碍需求，让实际使用者参与验收。便利性不能以失去可靠登录、焦点导航或辅助技术为代价。

15. 停止与升级处理条件

  • Fn 没有独立 kernel/input 事件，或不同工具观察结果矛盾。
  • 唯一的 Esc、Ctrl、Tab、Super 或唯一键盘即将被改写。
  • 当前已有无法解释的 XKB options、xmodmap、input-remapper autoload、hwdb 或厂商软件叠加。
  • 只有通过 root 常驻脚本、宽泛 hwdb、修改 /usr/share//usr/lib 或开放 /dev/input 权限才能继续。
  • 设备用于屏幕阅读器、kiosk、全盘解锁、生产登录或远程维护，却没有使用者验收和物理回退。
  • 测试产生重复、丢失 release、粘滞 modifier、睡眠/唤醒后变化或不同会话不一致。

保存会话类型、设备名称、实际事件、XKB options、工具版本和最小复现，交给桌面/发行版、input-remapper 或硬件厂商维护者；不要发布原始私密按键日志。

16. 官方与项目资料

资料核验于 2026-09-01。桌面、XKB 数据、硬件固件和 input-remapper 界面会变化；以本机版本的帮助和对应版本官方文档为准。

17. 2014 年原文档案（仅供溯源）

以下围栏逐字保留 source_export 的完整可见正文；未做尾随空白规范化或私密值遮盖。档案中的固定 X11 keycode、WinKey keysym 假设、重启即生效说法和 Fn/XF86WakeUp 等同关系仅作为惰性历史证据，不是现行配置。

~~~~markdown

Ubuntu下键盘按键替换
首先要知道键盘每个击键的Keycode， 这个可以使用xev在一台键盘layout相同的电脑上查到。

得知ESC的keycode是9，Symbol为”Escape” ,准备替换为WinKey（就是那个Windows logo的按键）,WinKey 的 keycode是115。

具体的做法是在用户的家目录下建立.Xmodmap 文件，里面输入以下代码，重启即可：

keycode 9 =WinKey
keycode 115 = Escape

用Fn键替换：

keycode 9 = XF86WakeUp
keycode 151 = Escape

用右Control键替换：

remove Control = Control_R
keycode 9 = Control_R
keycode 105 = Escape
add Control = Control_R

~~~~

Leave a Reply