如何实现Python项目根目录与子目录的跨目录运行及模块导入

仓库结构 #

/
├── SPS
│   ├── __init__.py
│   ├── SPS_run.py
│   └── components
│       ├── __init__.py
│       ├── comp1.py
│       └── comp2.py
├── Testing
│   ├── __init__.py
│   ├── Test_run.py
│   └── components
│       ├── __init__.py
│       ├── comp3.py
│       └── comp4.py
└── main_run.py

核心问题解决思路 #

要实现main_run.py、SPS_run.py、Test_run.py既能单独运行，又能互相调用，关键是让Python能正确识别模块搜索路径。之前修改工作目录的方式无效，因为Python的模块查找依赖sys.path而非当前工作目录，下面给出两种可行方案：

方案一：修改sys.path（兼容所有运行场景，推荐） #

在SPS_run.py和Test_run.py开头添加代码，将仓库根目录加入Python的模块搜索路径：

SPS_run.py 示例

import sys
import os

# 获取当前脚本所在目录
current_script_dir = os.path.dirname(os.path.abspath(__file__))
# 获取仓库根目录（当前目录的父级目录）
repo_root = os.path.dirname(current_script_dir)
# 确保根目录在模块搜索路径中
if repo_root not in sys.path:
    sys.path.append(repo_root)

# 正常导入本地模块
from SPS.components import comp1, comp2

# 后续业务代码

Test_run.py 示例

import sys
import os

current_script_dir = os.path.dirname(os.path.abspath(__file__))
repo_root = os.path.dirname(current_script_dir)
if repo_root not in sys.path:
    sys.path.append(repo_root)

from Testing.components import comp3, comp4

# 后续业务代码

main_run.py 示例（保持原有配置即可）

# 直接从根目录进行绝对导入
from SPS.SPS_run import *
from Testing.Test_run import *

# 后续业务代码

这种方式下，不管是直接运行子目录的脚本（如python SPS/SPS_run.py），还是从根目录运行main_run.py，都能正确导入模块。

方案二：相对导入+模块式运行 #

如果不想修改sys.path，可以使用Python的相对导入语法，但需要注意运行方式：

SPS_run.py 示例

# 使用相对导入，.代表当前目录的父包
from .components import comp1, comp2

# 后续业务代码

Test_run.py 示例

from .components import comp3, comp4

# 后续业务代码

这种方式的限制：

• 不能直接进入子目录运行脚本（如cd SPS && python SPS_run.py），必须从仓库根目录以模块方式运行：

  python -m SPS.SPS_run
  python -m Testing.Test_run
  

• main_run.py调用子模块时不受影响，因为是作为包导入的。

为什么修改工作目录无效？ #

os.chdir()仅改变程序运行时的工作路径，但Python直接运行脚本时，sys.path默认包含脚本所在目录而非修改后的工作目录。如果根目录不在sys.path中，依然无法通过from SPS.components import ...找到模块，因此直接修改sys.path是更可靠的方式。

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