使用subprocess.run调用脚本时无法找到PYTHONPATH中的模块

核心原因 #

你遇到的问题本质是subprocess默认不会继承父进程的shell环境变量，同时os.system在子进程中调用的是无环境变量的非交互式shell，导致无法读取到PYTHONPATH和系统PATH。

• 关于sys.path能看到模块路径：大概率是你的example.py脚本内部通过sys.path.append()手动添加了路径，或者父进程的Python解释器初始化时的默认sys.path包含该路径，但这部分路径并没有同步到系统环境变量的PYTHONPATH中，所以子进程的shell环境看不到。
• 关于os.system无输出：因为subprocess.run默认以shell=False模式启动子进程，此时不会加载shell的配置文件（比如.bashrc/.zshrc），$PYTHONPATH和PATH都是空值，自然输出为空。

解决方案 #

1. 显式传递父进程环境变量给子进程

将父进程的环境变量完整复制后传给子进程，确保PYTHONPATH被继承：

import os
import subprocess

# 复制父进程的所有环境变量
child_env = os.environ.copy()
subprocess.run(['python3.9', "scripts/example.py"], check=True, env=child_env)

2. 手动传递修改后的sys.path为PYTHONPATH

如果是在父进程中通过sys.path.append()动态添加了模块路径（而非系统环境变量中设置的PYTHONPATH），需要将当前sys.path转为PYTHONPATH格式传递给子进程：

import sys
import os
import subprocess

# 将当前Python进程的sys.path转为PYTHONPATH字符串
custom_pythonpath = os.pathsep.join(sys.path)
child_env = os.environ.copy()
child_env['PYTHONPATH'] = custom_pythonpath

subprocess.run(['python3.9', "scripts/example.py"], check=True, env=child_env)

3. 使用shell=True（谨慎使用）

如果你的脚本路径没有特殊字符（比如空格、引号），可以开启shell=True让subprocess通过shell启动，此时会继承shell的环境变量：

subprocess.run('python3.9 scripts/example.py', check=True, shell=True)

注意：shell=True存在安全风险，如果example.py的路径来自不可信输入，可能引发命令注入，建议仅在可控场景使用。

额外排查点 #

如果按上述方法仍无法导入模块，检查：

• 模块目录下是否有__init__.py文件（Python 3.3+ 允许无__init__.py的命名空间包，但部分场景仍需要）
• sys.path中添加的是模块的父目录而非模块目录本身（比如模块在/opt/my_module，则需要将/opt加入sys.path，而非/opt/my_module）
• 子进程使用的python3.9是否与父进程的Python版本一致，避免版本差异导致的路径问题

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