Python包ROSA多场景导入适配问题（直运/导入/编译）

针对你需要支持的三种运行场景，按以下步骤调整导入逻辑，确保全场景正常运行：

1. 统一使用包级绝对导入 #

所有模块内部的导入，都以ROSA包作为根路径，比如：

• 在main.py中导入foreign_potato_master：

  from ROSA import foreign_potato_master
  from ROSA import ROSA
  

• 避免使用相对导入（如from . import foreign_potato_master），因为直接运行脚本时，相对导入会触发ValueError: attempted relative import in non-package错误。

2. 动态调整sys.path适配直接运行场景 #

在main.py开头添加路径处理代码，确保直接运行脚本时，Python能找到ROSA所在的src目录：

import sys
from pathlib import Path

# 确定当前脚本的上级目录（即src目录）
root_dir = Path(__file__).resolve().parent.parent
# 将src目录加入sys.path的最前面，确保优先识别
if str(root_dir) not in sys.path:
    sys.path.insert(0, str(root_dir))

这样不管你是在src/ROSA目录下运行python main.py，还是在项目根目录运行python src/ROSA/main.py，都能正确导入包内模块。

3. 适配PyInstaller编译场景 #

PyInstaller编译后会将代码打包到临时目录，需要兼容这个特殊环境，修改上述路径处理代码为：

import sys
from pathlib import Path

if getattr(sys, 'frozen', False):
    # 编译为二进制后的临时目录路径
    root_dir = Path(sys._MEIPASS)
else:
    # 正常运行时的src目录路径
    root_dir = Path(__file__).resolve().parent.parent

if str(root_dir) not in sys.path:
    sys.path.insert(0, str(root_dir))

同时，打包时建议使用以下命令（确保PyInstaller能识别ROSA包）：

pyinstaller --paths ./src --onefile src/ROSA/main.py

--paths ./src参数会告诉PyInstaller去src目录查找依赖包，避免编译后出现ModuleNotFoundError。

4. 优化包导出（可选，提升用户导入体验） #

在src/ROSA/__init__.py中声明需要对外暴露的模块，方便用户导入：

from .ROSA import *
from .foreign_potato_master import *
from .main import main  # 如果需要让用户直接调用main函数

这样用户编写自定义包装器时，只需一行导入即可使用核心功能：

import ROSA

ROSA.main()

验证三种场景 #

1. 直接运行单脚本：执行python src/ROSA/main.py，无导入报错。
2. 用户导入自定义包装器：用户脚本中添加sys.path.append("项目根目录/src")（或通过pip install -e .将ROSA安装为可编辑包），即可正常导入使用。
3. PyInstaller二进制运行：编译后的二进制文件直接运行，无模块找不到的错误。

内容的提问来源于stack exchange，提问作者Cornelius-Figgle