解决input-remapper模块导入问题的技术指南

input-remapper是一款实用的输入设备重映射工具，但在某些Linux发行版上使用时可能会遇到"ModuleNotFoundError: No module named 'inputremapper'"的错误。这个问题主要出现在Arch Linux及其衍生发行版（如Manjaro）上，特别是通过AUR安装input-remapper-git包时。

问题根源分析

这个问题的本质是Python无法找到inputremapper模块，通常由以下几种情况导致：

1. Python环境混乱：系统中存在多个Python环境（如pyenv、系统Python和用户Python），导致模块安装路径与执行路径不一致
2. 残留安装文件：之前安装的残留文件干扰了新版本的正确加载
3. 权限问题：input-remapper需要特权进程运行，但相关模块未被正确安装到系统路径

详细解决方案

方法一：清理并重新安装

首先尝试最彻底的解决方案：

1. 完全卸载现有版本
2. 清理残留文件
3. 使用系统Python重新安装

具体步骤：

# 卸载现有版本
sudo pacman -Rns input-remapper-git

# 清理残留文件
sudo find /usr -name inputremapper -exec rm -rf {} \;
rm -rf ~/.local/lib/python*/site-packages/input-remapper*
rm -f ~/.local/lib/python*/site-packages/input-remapper.egg-link
rm -f ~/.local/lib/python*/site-packages/easy-install.pth

# 确保使用系统Python
pyenv global system  # 如果使用pyenv

# 重新安装
yay -S input-remapper-git

方法二：检查Python路径

如果问题仍然存在，可以检查Python的模块搜索路径：

python3 -c "import sys; print(sys.path)"

确保输出中包含inputremapper模块的实际安装路径（通常是/usr/lib/python3.x/site-packages/）。

方法三：验证模块位置

找到模块实际安装位置：

sudo find /usr -name inputremapper

如果发现多个安装位置，保留系统路径（/usr/lib/下的）的版本，删除其他位置的。

方法四：通过图形界面安装

部分用户报告通过GNOME软件中心安装的版本（如2.0.1r10.g7586ad99-1）可以正常工作，可以尝试此方法。

系统服务配置

安装完成后，需要正确配置系统服务：

sudo systemctl enable input-remapper
sudo systemctl start input-remapper

如果服务启动失败，检查日志：

journalctl -xeu input-remapper.service

技术原理深入

这个问题本质上反映了Python包管理在系统级应用中的复杂性。input-remapper作为需要特权运行的系统工具，其Python模块必须安装在系统Python路径中。当用户环境中存在其他Python管理器（如pyenv）时，安装过程可能会将模块安装到用户路径，而运行时又使用系统Python解释器，导致模块找不到。

最佳实践建议

1. 对于系统级Python工具，建议始终使用系统Python环境安装
2. 安装前临时切换到系统Python环境：pyenv global system
3. 定期清理Python包缓存和残留文件
4. 优先使用发行版官方仓库中的稳定版本

通过以上方法，大多数用户应该能够解决input-remapper的模块导入问题，正常使用这款强大的输入设备重映射工具。