运行Python脚本无法导入filegetter模块，但交互Shell可导入的问题

可能原因1：脚本与交互Shell的sys.path不一致 #

交互模式下Python会自动加载额外路径（比如用户目录的site-packages，或是通过~/.pythonrc、IPython启动脚本等自定义配置添加的路径），但直接执行脚本时不会加载这些配置，导致脚本的sys.path里没有filegetter的安装路径，而交互Shell里有。

验证方式 #

分别在交互Shell和脚本里执行以下代码，对比输出的路径列表：

import sys
print("\n".join(sys.path))

解决方法 #

• 临时方案：在脚本开头手动添加filegetter的安装路径到sys.path：

  import sys
  sys.path.append("/path/to/filegetter/installation")
  import filegetter
  

• 永久方案：将filegetter的安装路径添加到PYTHONPATH环境变量中（根据所用shell，修改~/.bashrc、~/.zshrc等文件）：

  export PYTHONPATH="/path/to/filegetter/installation:$PYTHONPATH"
  

可能原因2：模块安装路径未在目标Python的site-packages下 #

用python setup.py install安装时，若未指定正确的安装目标，模块可能被安装到了其他Python环境的路径中，即便你确认使用的是同一个Python可执行文件，安装时的环境变量偏差也可能导致路径不对。

验证方式 #

在交互Shell里执行以下代码，找到filegetter的实际安装路径：

import filegetter
print(filegetter.__file__)

查看该路径是否属于/home/ynx/miniconda3目录下的site-packages。

解决方法 #

切换到filegetter的源码目录，用conda环境的Python通过pip重新安装：

/home/ynx/miniconda3/bin/python -m pip install .

pip会确保模块安装到当前conda环境的site-packages目录，避免路径混乱。

可能原因3：交互Shell加载了自定义配置文件 #

如果你用的是IPython或其他增强型交互Shell，启动时可能加载了~/.ipython/profile_default/startup/下的脚本，或是~/.pythonrc文件，这些文件里可能添加了sys.path路径，但直接执行普通Python脚本时不会加载这些配置。

验证方式 #

检查是否存在上述自定义配置文件，查看其中是否有修改sys.path的代码。

解决方法 #

• 将配置文件中添加路径的代码复制到脚本开头；
• 或者将路径添加到PYTHONPATH环境变量，确保脚本和交互Shell都能识别。

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