monorepo环境下Python自定义模块导入失败问题求助

你遇到的导入错误核心是sys.path添加的路径层级错误：要使用from app2.api.foo1 import Foo1的导入语法，Python需要在sys.path包含的路径下能直接找到名为app2的包，因此你需要把**app2的父目录（即monorepo/services目录）**加入sys.path，而非加入app2本身的路径。你之前添加app2路径到sys.path后，Python会直接在app2目录下查找名为app2的子包，必然找不到，因此触发报错。

• 临时终端生效方案：切换到monorepo根目录后执行以下命令配置环境变量，仅对当前终端会话有效

  export PYTHONPATH="${PYTHONPATH}:$(realpath services)"
  

• 代码内动态适配方案：在foo2.py的所有导入语句前添加以下代码，不受运行环境影响

  import sys
  from pathlib import Path
  # 自动计算得到services目录的绝对路径
  services_path = Path(__file__).parent.parent.parent.resolve()
  # 用insert(0)优先加载当前项目的包，避免和全局同名包冲突
  sys.path.insert(0, str(services_path))
  

• 永久生效方案：将export PYTHONPATH="${PYTHONPATH}:/你的完整路径/monorepo/services"写入当前用户的shell配置文件（_/.bashrc、/.zshrc等），执行source ~/.zshrc（对应你使用的shell类型）后永久生效。

如果调整路径后仍然报错，可以按以下规则核对：

• 确认app2目录、api目录下的__init__.py文件确实存在，无拼写错误
• 运行脚本前打印sys.path输出，确认services目录的绝对路径确实在列表中，无拼写错误
• 避免使用相对路径添加sys.path，尽量用自动计算的绝对路径，避免工作目录切换带来的影响

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