最小侵入式从main.py导入subprogram中ExampleClass的方法

问题本质是：直接从根目录运行main.py时，Python的模块搜索路径不包含subprogram目录，导致dependency_0.py里的from module_2 import dependency_1无法找到目标模块。以下是无需修改subprogram内部文件的两种最小侵入方案：

方案一：修改main.py（推荐，持久有效） #

在main.py的最开头添加路径配置代码，将subprogram目录加入Python的模块搜索路径：

import sys
import os

# 获取subprogram目录的绝对路径，兼容不同操作系统
subprogram_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "subprogram"))
sys.path.append(subprogram_dir)

# 之后正常执行导入
from subprogram.module_1.dependency_0 import ExampleClass

原理 #

sys.path是Python查找模块的核心路径列表，添加subprogram目录后，Python会在该目录下检索module_2，完美适配dependency_0.py中的导入逻辑，且全程无需改动subprogram内部文件。

方案二：通过环境变量运行（无需修改代码） #

如果不想改动main.py，可以在运行前临时设置PYTHONPATH环境变量，指定subprogram的路径：

Windows 命令行 #

set PYTHONPATH=.\subprogram
python main.py

Linux/macOS 终端 #

export PYTHONPATH=./subprogram
python main.py

注意 #

这种方法仅对当前终端会话有效，每次运行都需要重新设置，适合临时测试场景。

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