Python项目中子文件夹模块导入失败：无法解析utils模块的问题求助

嗨，我完全懂这种模块导入卡壳的烦躁感！咱们先来理清楚问题出在哪，然后一步步解决它。

首先，你的项目结构没问题，__init__.py也到位了，核心问题其实是Python的模块搜索路径——当你直接运行login_management.py的时候，Python默认会把当前脚本所在的modules/目录加入搜索路径，而它的父目录NIDS_Proj/并没有被包含进去，所以Python找不到同级的utils文件夹。

下面给你几个靠谱的解决办法，你可以根据自己的开发习惯选：

方法1：手动添加父目录到搜索路径 #

在login_management.py的最开头加上这段代码，把项目根目录（NIDS_Proj）添加到Python的搜索路径里：

import sys
import os
# 获取当前脚本的绝对路径，再往上跳一级到项目根目录
project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.append(project_root)

# 现在就能正常导入了
from utils.hash_utils import hash_password, verify_password

这种方法的好处是不管你怎么运行脚本（直接跑或者用-m），都能正常工作，非常灵活。

方法2：使用相对导入（需配合模块方式运行） #

如果你想遵循更规范的包结构，可以用相对导入。把login_management.py里的导入语句改成：

from ..utils.hash_utils import hash_password, verify_password

这里的..表示“上一级目录”（也就是NIDS_Proj），但要注意不能直接运行login_management.py，必须在NIDS_Proj的父目录下，用模块方式启动：

python -m NIDS_Proj.modules.login_management

这种方式更符合Python包的设计规范，但对运行方式有要求。

方法3：设置PYTHONPATH环境变量 #

把项目根目录添加到PYTHONPATH环境变量里，这样Python会全局搜索这个路径下的模块。

• Linux/macOS终端：

  export PYTHONPATH="/绝对路径/NIDS_Proj:$PYTHONPATH"
  

• Windows命令提示符：

  set PYTHONPATH=C:\绝对路径\NIDS_Proj;%PYTHONPATH%
  

如果想永久生效，可以在系统环境变量里添加这个路径。这种方法适合长期开发这个项目的场景，一劳永逸。

另外补充一句：Python 3.3+其实已经支持无__init__.py的命名空间包了，所以你utils里的__init__.py不是问题所在，核心还是路径的事儿～

备注：内容来源于stack exchange，提问作者שהם טרבלסי