Linux下Python3.9使用Rich模块报ModuleNotFoundError求助

排查步骤与解决方案 #

1. 验证模块安装路径与Python搜索路径 #

先确认Rich模块的实际安装位置：

python3.9 -m pip show rich

记录输出中的Location字段。

接着查看Python3.9的模块搜索路径：

python3.9 -c "import sys; print('\n'.join(sys.path))"

对比两者，确保Rich的安装路径在sys.path列表内。如果不在，说明模块安装到了Python3.9无法识别的位置。

2. 强制重新安装Rich到Python3.9环境 #

执行以下命令，明确指定Python3.9的pip重新安装Rich，避免多版本Python环境混淆：

python3.9 -m pip install --force-reinstall rich==13.4.2

3. 检查用户权限与安装目录 #

如果Rich是用普通用户身份安装（默认会装到用户目录下的~/.local/lib/python3.9/site-packages），而你用root用户运行脚本，root的Python环境无法读取普通用户的模块目录。解决方法：

• 切换到安装Rich的普通用户运行脚本：su - your_username -c "python3.9 /opt/audit.py"
• 或者以root身份重新安装Rich：sudo python3.9 -m pip install rich==13.4.2

4. 清理PYTHONPATH环境变量干扰 #

如果系统中存在虚拟环境或其他Python路径配置，可能导致模块搜索异常。运行脚本前先清理环境变量：

unset PYTHONPATH
python3.9 /opt/audit.py

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