解决pdfarranger启动时报错"No module named 'dateutil'"问题

问题现象

在Fedora 40 KDE环境下安装pdfarranger后，应用程序无法正常启动。通过终端运行时会显示以下错误信息：

Traceback (most recent call last):
  File "/usr/bin/pdfarranger", line 5, in <module>
    from pdfarranger.pdfarranger import main
  File "/usr/lib/python3.12/site-packages/pdfarranger/pdfarranger.py", line 118, in <module>
    from .config import Config
  File "/usr/lib/python3.12/site-packages/pdfarranger/config.py", line 25, in <module>
    from .exporter import PrintSettingsWidget
  File "/usr/lib/python3.12/site-packages/pdfarranger/exporter.py", line 30, in <module>
    from . import metadata
  File "/usr/lib/python3.12/site-packages/pdfarranger/metadata.py", line 25, in <module>
    from dateutil import parser
ModuleNotFoundError: No module named 'dateutil'

问题分析

这个错误表明Python无法找到dateutil模块，而pdfarranger在处理PDF元数据时需要这个模块。在正常情况下，pdfarranger的RPM包应该已经声明了对python3-dateutil的依赖关系，系统会自动安装这个依赖。

解决方案

方法一：重新安装python3-dateutil

最直接的解决方法是重新安装python3-dateutil包：

sudo dnf reinstall python3-dateutil

这种方法最为安全，不会影响其他依赖包。

方法二：完整检查Python环境

如果问题仍然存在，可以检查Python环境：

1. 查看Python模块搜索路径：

python -m site

2. 确保python3-dateutil已正确安装：

rpm -q python3-dateutil

3. 检查pdfarranger的依赖关系：

rpm -qR pdfarranger

注意事项

1. 避免使用sudo pip：在系统范围内安装Python包时，应该优先使用dnf/yum等系统包管理器，而不是pip。使用sudo pip可能会导致包管理混乱。

2. 谨慎处理依赖关系：在移除包时，注意查看dnf提示的依赖关系变化。移除python3-dateutil可能会连带移除许多其他重要包。

3. 恢复误删的包：如果不小心移除了重要包，可以使用dnf历史记录恢复：

sudo dnf history
sudo dnf history undo <事务ID>

总结

pdfarranger依赖python3-dateutil模块来处理PDF文档的日期元数据。当出现"No module named 'dateutil'"错误时，通常是由于该模块未正确安装或Python环境配置有问题。通过重新安装python3-dateutil包可以解决大多数情况下的问题。在管理Python包时，建议始终使用系统包管理器而非pip，以保持系统稳定性。