Python跨目录导入模块问题：私有仓库模块引用报错

问题场景 #

本地工作目录结构：

app.py
other_repo/
   helpers.py
   logic.py
   ...

app.py要调用私有GitHub仓库other_repo里的模块，其中logic.py依赖同目录的helpers.py：

• other_repo/helpers.py代码：

  def get_value() -> int:
      return 5
  

• other_repo/logic.py代码：

  import helpers
  
  def multiply_value(x: int) -> int:
      value = helpers.get_value()
      return x * value
  

• app.py代码：

  import other_repo.logic as logic
  
  multiplied_value = logic.multiply_value(10)
  print(f'Multiplied value is {multiplied_value}')
  # 预期输出：Multiplied value is 50
  

运行app.py时，logic.py抛出ModuleNotFoundError: No module named 'helpers'。手动把logic.py的导入改成import other_repo.helpers能正常运行，但每次拉取仓库更新后，导入语句会被还原成原始内容。

可行解决方案 #

方案1：在app.py中添加Python路径（最省心） #

不用改仓库代码，直接在app.py开头加一段代码，把当前工作目录加入Python的模块搜索路径：

import sys
from pathlib import Path

# 把app.py所在目录加入模块搜索路径
sys.path.append(str(Path(__file__).parent))

import other_repo.logic as logic

multiplied_value = logic.multiply_value(10)
print(f'Multiplied value is {multiplied_value}')

这样Python就能从工作目录找到helpers模块，完美适配仓库里的原始导入语句，拉取更新也不会受影响。

方案2：通过环境变量临时指定路径 #

运行app.py的时候，用环境变量PYTHONPATH指定模块搜索目录，比如：

# 替换成你的工作目录路径
PYTHONPATH=/your/work/directory python app.py

这个方法适合不想修改代码的场景，每次运行前设置环境变量即可。

方案3：将私有仓库转为可安装包（需仓库修改权限） #

如果能修改私有仓库的代码，在other_repo根目录添加pyproject.toml或setup.py，把它变成一个可安装的Python包，然后本地执行pip install -e .安装为开发版本。之后仓库里的logic.py可以改成相对导入或者完整的绝对导入：

# 相对导入
from . import helpers

# 或者绝对导入
from other_repo import helpers

这种方法更规范，但前提是你有权限修改仓库的导入逻辑，且团队成员都能统一安装方式。

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