如何将PYTHONPATH设置为项目目录？解决模块导入失败问题

• 先验证PYTHONPATH是否生效
  终端执行echo $PYTHONPATH，查看输出是否包含/Users/username/documents/project_directory/：

  • 如果没显示，说明配置文件没加载：
    • 若用bash终端，你修改的.batch_profile大概率是笔误，正确文件应为.bash_profile，改完后执行source ~/.bash_profile刷新配置，或直接重启终端
    • 若用zsh终端，需修改.zshrc文件，同样执行source ~/.zshrc使配置生效

• 确认目录结构符合模块要求
  确保/Users/username/documents/project_directory/下的目录结构如下：

  project_directory/
  └── preprocess/
      ├── __init__.py  # 必须存在，空文件也可，Python靠它识别包
      └── utils.py     # 需包含get_image函数定义
  

  缺少__init__.py的话，Python不会将preprocess视为可导入的模块包

• 临时添加路径做测试
  在代码开头手动添加路径，验证导入逻辑是否正常：

  import sys
  sys.path.append("/Users/username/documents/project_directory/")
  from preprocess.utils import get_image
  

  如果这样能成功导入，说明问题出在PYTHONPATH的配置环节，回到第一步排查

• 虚拟环境下的特殊处理
  如果你使用了venv、conda这类虚拟环境：

  • 可激活虚拟环境后再设置PYTHONPATH；或者将路径写入虚拟环境的.pth文件：
    • 找到虚拟环境的lib/pythonX.X/site-packages目录（X.X为你的Python版本）
    • 新建一个后缀为.pth的文件（比如project_path.pth），文件内写入/Users/username/documents/project_directory/
    • 保存后重启Python解释器即可生效

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