如何在主脚本中为所有子脚本统一添加自定义Python模块路径？

这里有几个实用的方案，帮你不用在每个子脚本里重复写sys.path.append("/some/directory/")，直接从主脚本统一控制：

方法1：通过PYTHONPATH环境变量传递路径 #

Python启动时会自动把PYTHONPATH环境变量里的目录添加到sys.path中，所以主脚本可以修改环境变量后传给子进程，所有子脚本都会自动继承这个设置。

示例代码：

import os
import subprocess

# 复制当前环境变量，避免修改系统全局环境
current_env = os.environ.copy()
target_directory = "/some/directory/"

# 更新PYTHONPATH：如果已有就追加，没有就直接设置
if "PYTHONPATH" in current_env:
    current_env["PYTHONPATH"] = f"{target_directory}:{current_env['PYTHONPATH']}"
else:
    current_env["PYTHONPATH"] = target_directory

# 调用子脚本时传入修改后的环境变量
subprocess.call(["python", "my_script.py"], env=current_env)

优点：

• 完全不用修改任何子脚本代码，对所有子进程生效
• 符合Python官方推荐的模块路径管理方式
• 支持多个子脚本批量调用，一次设置全局生效

方法2：通过命令行预执行路径添加代码 #

如果不想修改环境变量，可以在启动子Python进程时，先执行添加路径的代码，再运行子脚本。这种方式直接在命令行完成，同样不用修改子脚本。

示例代码（处理普通路径）：

import subprocess

target_directory = "/some/directory/"
# 构造命令：先添加路径，再读取并执行子脚本内容
cmd = [
    "python",
    "-c",
    f"import sys; sys.path.append('{target_directory}'); exec(open('my_script.py').read())"
]
subprocess.call(cmd)

如果路径包含空格或特殊字符，记得用shlex.quote转义，避免语法错误：

import subprocess
import shlex

target_directory = "/some/directory/with spaces/"
quoted_dir = shlex.quote(target_directory)
cmd = [
    "python",
    "-c",
    f"import sys; sys.path.append({quoted_dir}); exec(open('my_script.py').read())"
]
subprocess.call(cmd)

优点：

• 无需修改环境变量，临时生效，不影响其他程序
• 适合临时调试或路径需要动态变化的场景

方法3：将子脚本作为模块运行（需调整目录结构） #

如果你的子脚本可以被当作Python模块调用，可以结合PYTHONPATH设置，用python -m的方式启动子脚本。不过这个方法需要你调整子脚本的目录结构，确保它能被识别为模块（比如所在目录包含__init__.py）。

示例代码：

import subprocess
import os

target_directory = "/some/directory/"
current_env = os.environ.copy()
current_env["PYTHONPATH"] = target_directory

# 假设my_script是目标目录下的可运行模块
subprocess.call(["python", "-m", "my_script"], env=current_env)

注意：这个方法适合长期维护、有规范包结构的项目，能让代码组织更清晰。

综合来看，**方法1（PYTHONPATH环境变量）**是最通用、最省心的方案，适合批量调用多个子脚本的场景，完全不用改动子脚本的代码。

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