如何在Python脚本内指定导入源目录，无需修改现有导入结构

假设你的项目目录结构如下：

project_root/
├── scripts_folder/
│   └── my_script.py  # 你要运行的目标脚本
└── other_scripts_folder/
    ├── __init__.py
    ├── core/
    │   ├── __init__.py
    │   └── utils.py  # 内部使用相对导入，比如from .helper import ...
    └── helper.py

下面是无需修改命令行PYTHONPATH的Python内部解决方法：

方案一：动态添加共同父目录到sys.path（推荐） #

在my_script.py的最顶部（所有导入语句之前）添加以下代码，将两个文件夹的共同父目录（project_root）加入Python的模块搜索路径：

import os
import sys

# 获取当前脚本所在目录的父目录（即project_root）
project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
# 把父目录插入到sys.path最前端，确保优先级最高
sys.path.insert(0, project_root)

# 现在可以用绝对导入正常调用other_scripts_folder里的模块
from other_scripts_folder.core.utils import some_function

为什么有效：将共同父目录加入sys.path后，Python会把other_scripts_folder识别为合法的包，其内部的相对导入会基于自身包结构正常工作，不会破坏原有代码的导入逻辑。

方案二：使用importlib.util手动加载指定模块 #

如果仅需导入单个特定脚本，不想全局修改sys.path，可以用importlib.util直接加载目标文件：

import importlib.util
import os

# 拼接目标脚本的绝对路径
target_script_path = os.path.join(
    os.path.dirname(os.path.dirname(os.path.abspath(__file__))),
    "other_scripts_folder",
    "core",
    "utils.py"
)

# 创建模块规范并加载
spec = importlib.util.spec_from_file_location("other_scripts_folder.core.utils", target_script_path)
utils_module = importlib.util.module_from_spec(spec)
spec.loader.exec_module(utils_module)

# 调用模块内的函数/变量
utils_module.some_function()

适用场景：仅需导入少量模块，避免全局修改sys.path带来的潜在冲突。

常见坑点说明 #

• 不要直接将other_scripts_folder加入sys.path：这会让它被识别为顶层模块，内部的相对导入（如from . import xxx）会因缺少包上下文抛出异常
• 优先用sys.path.insert(0, ...)而非append：确保目标目录的优先级高于系统默认路径，避免同名包冲突
• 保留other_scripts_folder下的__init__.py：Python 3.3+支持无此文件的命名空间包，但对于依赖相对导入的旧代码，这个文件能明确包结构，避免导入异常

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