Linux下创建安装自定义键盘布局 解决配置被覆盖加载失败问题

问题根因说明 #

你之前测试到的用户目录XKB配置不生效，是因为setxkbmap依赖的旧版libxkbfile库本身不支持读取$HOME/.xkb、$HOME/.config/xkb路径，你看到的官方说明是libxkbcommon库的特性，仅支持Wayland合成器、新版桌面环境等使用新库的组件。

方案1：用户级配置（推荐，完全不受系统更新影响） #

该方案所有配置都存在用户家目录，系统更新XKB包不会产生任何影响：

• 第一步：创建用户级XKB目录结构

mkdir -p ~/.config/xkb/{rules,symbols}

• 第二步：拷贝系统默认规则文件到用户目录，后续修改仅针对用户目录下的文件

cp /usr/share/X11/xkb/rules/evdev ~/.config/xkb/rules/
cp /usr/share/X11/xkb/rules/evdev.lst ~/.config/xkb/rules/

• 第三步：将你之前在系统symbols/de中定义的自定义colemak变体，写入~/.config/xkb/symbols/de文件，不需要复制原有系统配置，仅保留自定义变体即可
• 第四步：使用组合命令加载自定义布局，绕过setxkbmap的路径限制

setxkbmap -I ~/.config/xkb de colemak -print | xkbcomp -I ~/.config/xkb - $DISPLAY

如果你使用Wayland环境，GNOME、KDE等主流桌面会自动读取~/.config/xkb下的配置，直接在桌面键盘设置中选择对应的自定义变体即可生效。

方案2：系统级配置防覆盖（适合多用户共用自定义布局的场景） #

如果需要所有系统用户都能使用你的自定义布局，可以通过包管理器规则屏蔽覆盖行为：

• 编辑openSUSE包管理器配置文件/etc/zypp/zypp.conf，找到EXCLUDE_PATTERNS配置项，添加你修改过的XKB文件路径：

EXCLUDE_PATTERNS = /usr/share/X11/xkb/rules/evdev.lst /usr/share/X11/xkb/rules/evdev.xml /usr/share/X11/xkb/symbols/de

配置完成后zypper更新XKB相关包时，会自动跳过覆盖你修改的这几个文件。

验证方法 #

执行以下命令，能输出你的自定义变体相关信息即代表加载成功：

xkbcomp $DISPLAY - | grep -i colemak

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