在Testfiles文件夹运行StrucPy包遇ModuleNotFoundError，移出可正常运行求解决

问题场景 #

• 在「Testfiles」子文件夹内运行testfile1.py时，触发ModuleNotFoundError: No module named 'StrucPy'
• 将testfile1.py移到「Testfiles」所在的上级目录时，能正常导入StrucPy包
• StrucPy包的__init__.py包含代码：from StrucPy import RCFA
• 文件夹结构如图：
  

解决方法 #

方法1：临时添加Python搜索路径 #

在testfile1.py开头加入以下代码，把StrucPy所在的上级目录纳入Python搜索范围：

import sys
from pathlib import Path

# 获取当前脚本目录的上级目录（即StrucPy所在目录）
sys.path.append(str(Path(__file__).parent.parent))

之后再执行import StrucPy即可正常导入。

方法2：以可编辑模式安装包（推荐） #

打开终端，切换到包含StrucPy和Testfiles的上级目录，执行命令：

pip install -e .

此操作会把StrucPy以可编辑模式安装到Python环境，后续无论在哪个目录运行脚本都能直接导入，且修改包内代码无需重新安装。

方法3：修正__init__.py的导入逻辑 #

如果RCFA是StrucPy包内的模块（比如StrucPy/RCFA.py），将__init__.py的导入语句改为相对导入：

from .RCFA import *  # 也可指定具体要导入的类/函数

原绝对导入语句from StrucPy import RCFA会因路径搜索优先级问题报错，相对导入可避免该问题。

方法4：设置永久环境变量 #

在系统中配置PYTHONPATH环境变量，添加StrucPy所在的上级目录路径：

• Windows：在「系统属性-高级-环境变量」中新建PYTHONPATH变量，值填写对应路径
• Linux/macOS：终端执行export PYTHONPATH=$PYTHONPATH:/path/to/strucpy-parent-dir，若要永久生效，将该语句添加到~/.bashrc或~/.zshrc中

配置后Python会自动在该路径搜索包，不受脚本所在位置限制。

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