在keyd中实现QWERTZ键盘布局的AltGr组合键映射

背景介绍

keyd是一款强大的键盘重映射工具，它允许用户在Linux系统上自定义键盘行为。对于使用QWERTZ键盘布局（主要在德语区使用）的用户来说，经常会遇到一个特殊需求：如何让Ctrl+Alt组合键实现与AltGr（右Alt键）相同的功能，同时又不影响系统原有的Ctrl+Alt快捷键功能。

问题分析

在QWERTZ布局中，许多特殊字符（如@、|等）需要通过AltGr组合键输入。例如：

• AltGr + Q 产生 @
• AltGr + <（102nd键）产生 |

然而，Linux系统默认不支持通过Ctrl+LeftAlt组合来实现这些特殊字符输入，这给习惯Windows操作方式的用户带来了不便。

解决方案探索

初步尝试

用户最初尝试了简单的键映射：

[main]
leftcontrol+leftalt+102nd = rightalt+102nd
leftcontrol+leftalt+q = rightalt+q

但这种直接映射方式在keyd中不被支持，因为rightalt+102nd不是有效的语法。

理解keyd的工作原理

keyd工作在键码（keycode）层面，而非键符（keysym）层面。这意味着：

1. keyd处理的是物理按键事件，而非最终产生的字符
2. 布局映射需要在显示服务器（X11/Wayland）层面设置
3. keyd的映射需要基于物理按键名称（可通过keyd monitor查看）

正确配置方法

经过多次尝试和讨论，正确的配置方式应该是：

[alt]
leftcontrol = swap(custom-alt-control)

[control]
leftalt = swap(custom-alt-control)

[custom-alt-control:C-A]
q = macro(G q)
102nd = macro(G 102nd)

这种配置实现了：

1. 当同时按下LeftCtrl和LeftAlt时，进入自定义层
2. 在该层中，q键被映射为AltGr + q的组合
3. 102nd键被映射为AltGr + 102nd的组合

技术细节说明

1. 宏定义：macro(G q)表示模拟按下AltGr（G代表AltGr）后再按q键

2. 层切换：swap(custom-alt-control)创建了一个临时层，只在Ctrl+Alt按下时激活

3. 键码名称：必须使用keyd monitor显示的名称，而非布局中的字符

4. 布局设置：建议在显示服务器中设置正确的键盘布局（如德语布局）

注意事项

1. 这种配置不会影响原有的Ctrl+Alt+Fn等系统快捷键

2. 如果需要更多特殊字符映射，可以继续在[custom-alt-control:C-A]段中添加

3. 对于不同的键盘布局，键码名称可能有所不同，务必使用keyd monitor确认

总结

通过keyd的层切换和宏功能，我们可以优雅地实现QWERTZ布局中Ctrl+Alt组合键的特殊字符输入功能，同时保持系统原有快捷键不受影响。这种方法展示了keyd强大的键盘定制能力，也为其他类似需求提供了参考解决方案。