终端运行脚本报ModuleNotFoundError，但Python解释器中正常

这种情况其实是Python模块导入机制的常见坑，我帮你拆解一下可能的原因和对应的解决方案：

核心原因排查 #

先从几个关键方向确认问题：

1. 导入语句与目录名不匹配 #

你提到包目录是PackageDir，但脚本里导入的是Package——这大概率是问题所在！交互式环境中能成功导入Package，是因为启动交互式解释器时，Python会自动把当前工作目录（MainDir）加入sys.path，如果MainDir下恰好有个叫Package的子目录（可能你实际目录名和描述的PackageDir不一致），就会被找到；但执行脚本时，Python优先把脚本所在目录（ScriptDir）加入sys.path，如果你的PackageDir路径虽然在sys.path里，但导入的名字和目录名不匹配，自然会报错。

2. 执行脚本与交互式用的不是同一个Python解释器 #

很容易忽略的一点：你终端里启动的交互式Python，和执行python ScriptDir/script.py用的可能不是同一个解释器（比如一个是conda环境的Python，一个是系统默认Python）。PYTHONPATH的设置是绑定到当前shell环境的，如果脚本用的是另一个Python，它的sys.path不会包含你设置的路径。

3. 脚本执行时的sys.path未正确加载PYTHONPATH #

虽然你说已经把PackageDir加入PYTHONPATH，但有些场景下环境变量不会被正确传递：比如用sudo执行脚本，或者在IDE的终端里执行时环境变量未同步。

4. 命名冲突 #

如果ScriptDir里存在和你要导入的包同名的文件（比如Package.py）或目录，Python会优先加载脚本所在目录的模块，而忽略PYTHONPATH里的路径。

具体解决方案 #

方案1：修正导入语句或目录名 #

• 如果你的包目录确实叫PackageDir，把脚本里的import Package改成import PackageDir；
• 或者把PackageDir重命名为Package，保持导入语句和目录名一致，这样更符合Python的包命名习惯。

方案2：确保用同一个Python解释器执行脚本 #

在交互式环境中执行以下命令，得到当前Python的绝对路径：

import sys
print(sys.executable)

然后用这个绝对路径执行脚本，比如：

/home/user/anaconda3/bin/python ScriptDir/script.py

方案3：在脚本中手动添加包路径（最稳妥的方法） #

不需要依赖PYTHONPATH，直接在script.py开头加上这段代码，动态添加包目录的绝对路径：

import sys
from pathlib import Path

# 获取MainDir的绝对路径（脚本的父目录的父目录）
main_dir = Path(__file__).parent.parent.absolute()
# 拼接PackageDir的路径
package_dir = main_dir / "PackageDir"
# 如果路径不在sys.path里就添加
if str(package_dir) not in sys.path:
    sys.path.append(str(package_dir))

# 现在可以正常导入包了
import PackageDir  # 或者import Package，根据你的目录名调整

方案4：检查并解决命名冲突 #

查看ScriptDir下是否有Package.py、Package/这类和导入包同名的文件/目录，有的话重命名它们即可。

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