Xournal++手写笔按钮在Ubuntu 24.10 Wayland环境下的异常行为解析

问题现象

在Ubuntu 24.10升级后，用户在使用Lenovo Thinkpad X1 Yoga Carbon（第六代）设备时发现，手写笔的非橡皮擦按钮（靠近笔顶部的第二个按钮）在Wayland环境下出现异常行为。具体表现为：

• 预期功能：按下按钮应激活预设的高亮工具
• 实际现象：按钮按下时以0压力值绘制细线，而非切换至高亮工具

技术分析

通过输入事件日志对比，发现异常行为源于按钮事件映射错误：

正常事件序列：

1. 按下按钮2（手写笔侧键）
2. 移动通知
3. 按下按钮1（笔尖接触屏幕）
4. 移动通知
5. 释放按钮1（笔尖离开屏幕）
6. 移动通知
7. 释放按钮2（松开侧键）

异常事件序列：

1. 按下按钮1（错误地将侧键识别为笔尖接触）
2. 移动通知
3. 再次按下按钮1（实际笔尖接触）
4. 移动通知
5. 释放按钮1（笔尖离开）
6. 移动通知
7. 释放按钮1（松开侧键）

根本原因

该问题并非Xournal++本身的缺陷，而是源于GNOME控制中心的默认设置变更。在Ubuntu 24.10中：

• 默认将手写笔按钮映射为"左键点击"
• 正确应映射为"中键点击"

这种映射错误导致系统将手写笔侧键事件错误识别为笔尖接触事件。

解决方案

通过GNOME设置调整输入设备配置：

1. 打开GNOME控制中心
2. 进入"鼠标和触摸板"设置
3. 找到手写笔按钮映射选项
4. 将默认的"左键点击"改为"中键点击"

技术启示

1. 输入事件传递链：Wayland环境下输入事件需经过多层传递（libinput→Compositor→GTK→应用），任何环节的映射错误都会导致最终行为异常
2. 设备兼容性：系统升级可能改变默认设备配置，特别是输入设备映射这类底层设置
3. 诊断方法：通过输入事件日志分析是定位输入类问题的有效手段

延伸建议

对于Linux平板/二合一设备用户：

• 重大系统升级后应检查输入设备配置
• 遇到类似问题时，可尝试在不同桌面环境或显示服务器（X11/Wayland）下测试
• 复杂输入设备（如压感笔）建议记录原始输入事件用于问题诊断

该案例展示了开源生态中组件交互的复杂性，也体现了通过系统设置调整解决兼容性问题的典型思路。