同一仓库下不同应用的Python相对导入兼容问题求解

你有manager和Android_bot两个应用共享同一仓库，存在两种目录结构：

1. Android_bot作为manager的子目录，入口为manager/main.py

   -- manager
      -- main.py（程序入口）
      -- Android_bot
        -- utils
          -- util.py（原导入：from ..scraper.account import Account）
        -- scraper
            -- account.py
   

2. Android_bot作为独立主目录，入口为Android_bot/main.py

   -- Android_bot
      -- main.py（程序入口）
      -- utils
        -- util.py（原导入：from scraper.account import Account）
      -- scraper
          -- account.py
   

当前问题：第二种场景下直接导入正常，但第一种场景用相对导入会报错ImportError: attempted relative import beyond top-level package，以下是几种兼容两种场景的解决办法：

方案1：动态路径适配（无需额外配置） #

修改util.py的导入逻辑，先尝试直接绝对导入，失败则自动调整路径：

import sys
from pathlib import Path

try:
    # 优先尝试作为独立主目录的导入方式
    from scraper.account import Account
except ImportError:
    # 当作为子目录时，把Android_bot目录加入Python搜索路径
    android_bot_root = Path(__file__).parent.parent
    sys.path.append(str(android_bot_root))
    from scraper.account import Account

这种方式不需要修改项目结构，通过代码自动适配两种环境，适合快速解决问题。

方案2：将Android_bot封装为本地包（推荐长期使用） #

把Android_bot做成可安装的本地包，两种场景下统一用包名导入：

1. 在Android_bot目录下创建pyproject.toml文件：

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[project]
name = "android_bot"
version = "0.1.0"

2. 执行开发模式安装：
   • 若Android_bot是主目录：在Android_bot目录下运行pip install -e .
   • 若Android_bot是manager的子目录：在仓库根目录运行pip install -e ./Android_bot
3. 修改util.py的导入语句为：

from android_bot.scraper.account import Account

这种方式从根本上解决路径依赖问题，不管Android_bot放在哪个位置，只要包已安装就能正常导入，适合长期维护的项目。

方案3：统一运行方式（不修改代码） #

两种场景下都用模块方式运行，统一使用相对导入：

1. 在Android_bot的根目录、utils目录、scraper目录下都添加__init__.py文件（Python 3.3+可以省略，但显式添加更稳妥）
2. 修改util.py的导入语句为统一的相对导入：

from ..scraper.account import Account

3. 运行时：
   • 第二种场景（Android_bot为主目录）：用python -m Android_bot.main代替python main.py
   • 第一种场景（Android_bot为子目录）：直接运行manager/main.py即可，此时Android_bot会被识别为manager的子包，相对导入正常工作

原理：用-m参数运行时，Python会以包的视角解析模块，相对导入的层级会基于包结构而非脚本的执行路径。

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